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Abstract 


CP-67/CMS is a general purpose time-sharing system developed 
for the IBM 360 at the Cambridge Scientific Center. This guide 
describes the facilities of CP-67/CMS and provides detailed 
information about the user commands available and their usage. 
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INTRODUCTION 


Components of the System 

The CD/CMS time-sharing system is composed of two independent components: the 
Control Prograin (CP) and the Cambridge Monitor System (CMS), 

CYP buildseand maintains for cach user a "virtual machine", Lhe virtual ynachine is 
indistinguishable to the user and his proprams from areal machine, but is really 
one of many CP is managing. CP allocates the resources of the real machine to 
each virtual machine in turn for a short "slice" of time, then moves on to the next 
virlual machine, 


Since the virtual machines are simulated, their configurations may differ frorn each 
other and from the realanachine, Hach uset controls his virtual machine from his 


termingl, which is, effectively, his console keyboard, 


Tike real machines, virtual muchines will opsrate most efficiently under an operating 
systern, She Cambridge Monilor Systera (CMS) is designed to allow full use of a 
System /360 threveh a siople commoaand language entered at the console (in the case of 
a virtual aiachine, at the terminal), CMS pives the user a fall range of capebilitics -- 
creating and managing files, compiling and executing problem programs, and de- 
buyging-- using only his remote terruinal. Since each user has his own virtual 
machine with his own copy of CMS "in it", nothing he does can affect any other user. 

In uddition, since users cannot pet "outside" their virtual machines, CP is protected 
from any user error, 


The Control Pri Virtual Machines 








Kycfore a user is authorized to use CP, he must be assigned a USINRID, which identifies 
lim to the system, and a pussword, which is checked when he "logs in', Associated 
with each USERID is a table describing the virtual machine assigned to that user. 
Whenever he Jops in, CP sets up this virtual machine for him. Although all the 
virtual machines may be different, most will be set up with the configuration expected 
by CMS, the most conunonly used operating system, They will include at least 256K 
bytes of core storage, two disk drives, a console (the terminal), a card-read- 
punch unit, and a printer - another disk drive and two tape drives are optional 
(tapes must be ‘enabled on request, by the system operator), ‘She real system will 
usually have a larger nwuabcr of disk drives and/or a drum, more tape drives, and 
perhaps more core storage. 
age ees vio ie ay Hep virtual core, 
slorage called ioneean AM oe Pies ei mae nat oases Soe reac 
direct access Becondiis, etaieeees as ee aa a ae neki sy EG yeti e 
i Ae a reer erica ae Cae es ns pas a Pe bee mee status they are 
one virtual machine, another vereual eee eee as . oes PeMe porlormed fae 
“Ne C > Operating, 


a technique called 


The paging operation 


‘the proper 1/O interrupt is simulated, 


a) 


6-1-68 
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and resultant allocation of real core to a given user's pages, appear random 


to the systera, Special hardware is provided on the System/360, Model 67 


Ahat translates, at cxecution time, the user's (or user prograin's) addresses 
into the current real addresses of the randomly located pages, 


This is called 
“dynamic addross translation"; it is transparent to the user, 

Because of the virtua) machine concept employed by this system, only the 
Control Program (CP) may operate in the supervisor state on the real machine. 
All prograins other than CP ~+ all programs exccuted on virtual machines -< 
operate in the problem state on the real machine, By a special interrupt- 
handling procedure, however, CP supports what armounts to a virtual supervisor 


state on the virtual machine, All user interrupts, including those caused by 


‘alteanpled privileged operations, arc handled by CP, which reflect to the user 
‘program only those the user program would expect from a real machine. 


The 
user may expect his programs to execute on his virtual machine in a manner: 
identical to their ‘éxecution on a real machine, 


Since many users, through their virtual machines, require system resources 
that togethey ean total many times the resources of the real system, ‘the system 
operator must occasionally take steps to maintain adequate response firme for 
all users. CP recopnizes that certain kinds of jobs on virtual machines -- 
large assemblies or compilations, for cxarnple -- can cause heavy paging 

loads or otherwise tax the Control Program. CP will attempt to schedule 


‘the different jobs so as to maximize the total throughput of the system while 


maintaining a fast response time for those users whose demands are lighter 
but whose responses must be quicker, The operator-can also limit the total 
number of users supported at any one time. Operator-imposed parameters 


tay be obtained by issuing the QUERY console function. 


‘All virtual machine I/O operations are handled by CP, which inust translate 


them into real machine I/O operations. This requires two translations, 
accomplished as follows: CP intercepts all user 1/O when Start 1/O is issued, 


It translates virtual device addvesses into real device addresses, translates 


virtual core storage addresses into real core storage addresses, ensures 


“that all necessary payes are in real core storage, builds a CCW string for 
‘the user, and issues SIO when the channel is free, 


When CP receives an 

intcrrupt indicating 1/O completion, it scts a "ready-to-run" flag in the user's’ ‘ 
virtual machine status table; when control is returned to the virtual machine, 

The virtual rnachine is not given 

control from the time it issues a SIO until CP delivers the simulated 1/0 

interrupt. In the meantime, another virtual machine(s) may be operating. 
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All virtual machine unit record 1/O is spowled on disk by CI. Shoe, ewy enrd deck 
tobe Vread! by ew virtual anachine aust have boon read Ly CP prices ta the unests 
call for it on his virfuel-roachine; the pluyaical duck must love beou po ocedae by 


USERID, s0 CY lnows v bo the card-imiaye file is for, later, 
when the vir€ualiunechincn has Uread' the card deck, # card reader ondeofefilos is 
sipadated, Card and pointer oufpul, similarly 


‘ 


speoled, is net queucd for physical 
the user Jens off 
the system (end-ef-file is assumed); the CLOSE console function specifics the 
(viriue)) address of the device fo be closed; of CP detects an invalid CCW addresre 
to the device (end-of-file is assuined), Further output for a closed device is 
assumed to slart a new file, So that the syste:n operator cau separate physical 
output, printed and punched oufpat, files are always preceded by a record (supplied 
by CP) that contains the USERID. 


output eetil CP is netified of cud-of-file in ane of theae ways: 


. 


Vhe CP console furedons allow the user to ca.tro) his virtual soavchise from the 
terminal) much as an operator controls a real rpachine, To performs anJUh, for 
instapee, the user types "IPL" and a device address, The uner can stop his 

virtual poaching at any Gine (by depressing th: ATTN key) and request dicplsy af 
any porticu of his storape and repisters, 


and restart hes pmiachisae. 


Lie can modily the contents, if desircd, 
CP also recopnises a few special purpose comrunauds, 
such es the QUERY function mentioned above, which are not normal console finctio: 





The Cambridge Monitor System 


The Cambridge Monitor System 
system, capable ef running ona 


(CMS) is a single-user, conversational] operating 

real machine as well as ona virtual machine, . It 
interprets a simple command langiuape typed in at the operator's console (in this 

casey, the user's remote terminal), ‘ ! 


Whether running on a real or a virtual machine, CMS expects the following machine 
configuration: 
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device virtual 


address 


symbolic 
name 


~——m —o “ 
en oe ee! ede a ee ee ee ee eae eed 


1052. 009 


CON] console 
231) 190 DSK1 system disk (read-only) 
2301 191 DSK2 permanent disk (user files) ; 
231) 192 DSK3 temporary disk (work space) 
1403 OOE FPRWNI line printer 
2540 00C RDR1 card reader 
2540 00D PCH card punch 
2400 180. TAPI tape drive 
2400 18) TAP2 tape drive 


At least 256K bytes of core storage. 


lineata edt oe ee ee ee 


ewer awe wwe RE DEM OOO we eee 


Note that the above devices represent the minimum configuration for CMS 
except for the following three devices, which are optional: DSK3 at virtual 
address 192, TAP] at virtual address 180, and TAP2 at 181. 
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Suder OD, of course, Ureue devices are siraulated and reraapped to aii layout 
addresses and/er differant devices. For instance, CMS ca.pects a )052 printer- 

ete ae eh Mas. Sei cghas “IAs €" ie aia NTA oe 
heyboard operator's console, bul most remote termiuals wre 27415; CP handles 


all chenne) propaain modifications necessary for this siinvletion, 


Under CP, al) CMS users share the reed-only syeler Gish; on it reside the CHS 
nucleons rowlines, which the user 1PLs, acd the other routines and Ubrorics that 
CMS calle as needed. Since each virtual roachive anaintains ifs awn copy of CMS, 
users may modify it as they wish without affecting either the systems disk version 


or the copics in other virtuel machines, 


CMS Cainwands: 
GMS comiuands fall naturally into four categories: file manipulation, compilation, 


execution control, and debugging aids. 


Vhe file handling commands allow the ustty fo create, copy, wove, ¢ ainbing end 
erase disk files. Other comrmads provide access to the tape units, privtex, 
and card-read-punch, Under the CMS Jinkage scheme, ald of these comnands 


are available to executing, programs as well as to the user at the teroinal, 


The CMS languape procéscsors are the same ones used under Operatiug System /360 
(OS); these ‘include Auserabler (F), FORYRAN IV (G), and PL/I (EF). The Assembler 
produces object programs that ray be executed under either ChE or OS, dependiry 
on (he uacros used in the source proprian, Special file-bendiiog routines for 
macro libraries are included. Uhe FORTRAN and PL/] compilers also produce 
O8-compatible object proprains. (The FORTRAN excculion-linie support programs 
have been modified for CMS.) Vhe SNODOI, cmupiler and asscmbler-interpreter 
were adapted from programs designed to execute under OS. 


The exccution control commands allow the user to load his programs from single 
object decks (the filetype TEXT is reserved for relocatable object programs) or 
froin a library of programs. Te can pass a list of pararneters to his propram 
from the terminal, and specify the point at which execution is to begin. To avoid 
relocation (bypass the relocating loader) he can create a file consisting of an 
image of the portion of core storage contyining his program, and Jood that non- 
relocatalle copy back at any time. Since the loading commmiands can be accessed 
by executing programs, overlay structures may be sect up. 
create a file which is a series of commands, and then execute these commands 
by typing a single line (loading and executing that file), 


The user can also 


The debupping facility of CMS allows the user to stop his programs at pre- 

determined points and cxamine his registers, PGW, and storage, and modify these 
She desires, This information may be typed oul at this terminal or printed off{- 
line, A program interrupt gives control to DE RUG, as docs the external interrupt 
caused by the EXTIERNAJ, console function. The user may also employ the program 
tracing routines, which record all SVC transfers, or will record just those in 

which an crror return is made. 
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2.0.0 CP/CMS CONVENTIONS - 


Various “rules” or couventions must be observed when using the CP/CMS 
system, These are discussed in the following sections. ‘Taclided are a | 
discussion of the file facilities available to the CMS user and the methods 
of jdentifying these files, a description of the 2741 and 1050 teximinals 
and thejrase, aud a description of the preccdures to be used when logeiig 
in and oul of the sysigin, Also given axe rules for typing input to the 
systcin form a terminal, anda dese cipuion | of cach of the cnvironments 

to which this input Indy he entered, 
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- 2.4.0 FILE CONVENTIONS 


One of the purposes of CMS is to provide the user with various file-handling 
facilities. Files to be used undex CMS may he stored on disk, cards, or magnetic 
tape. However; most CMS commands assume that files are stored on disk. This 
means that files store cl on media other than disk must be transferred to disk before 
many of the CMS commands can be issued for them. The coramands which deal with 
transferring files between disk and other media are discussed in Sections 3.41.0. 

Conventions piven in this section apply to disk files only. 


Disk Vacilities | 
‘Iwo disk arcas are available to cach CMS user for storing information. These 
are the permanent disk arca, where stored information is retained until the user 
requests that all or part of it be deles.d, and the temporary disk area, where 
information is retained only from the time it is created util the user ends his 
fenniial Seuss Ds For convenience, the se two areas are often referred to as 
the user's “pormanent disk" and his ‘ ‘tempor ary disk" respectively, although 
the size of each area scldom coustitutes an entire physical disk. The sizes of a 
user's permanent. and temporary disks are assipmed by the system administvator 
at the time be establishes that person as an authorized user-of the CP/OM5 eystem, 
‘These assigned sizcs are based on the amount of disk space available and the aniount 
which the user is likely to require. Assigned disk sizes may vary among users. 


A third disk area accessed by cach user is:the system disk, which is composed of 
(4) the CMS nucleus, of which cach user ree cives a copy, and (2) the disk-resident 
portion of CMS, which is shared by all users. ‘The system disk is read-oaly; any 
attempt Lo write on it will be denied and will cause an error message to be typed 
to the uses. 


Information stoxed on the permanent, temporary, and aye stem disks is avec 
into files. Files on the permanent and/or temporary y. disks are referred to as “user 
files''; those on the system disk are xceferred to as Sayer files," 


File Identifiers 


Each file must have a unique identifier, which is composed of a filename, 
a filetyp¢, and a filemode. This identifier, or a portion of it, is used by 
the various CMS commands to access user and system files. If a new 
file is created with an identifier identical to that of an existing user file, 
the original file will be erased, 
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Yhe filenenve may be any cormbination of from 1] to & nen-blank lenCvic 
characters provided the first character is not a zero, an asterisk, a 
period, or a left parenthesis. With system files, the filename is the name 
which is issued by the user in calling a specific command, and is also the 
name of the program whore code constitutes that command, Permanent and 
temporary files may be assigned any filename the user wishes vince filenames 
in thamsclves do not have any special implications in CMS, 


These 


Filetype may be any combination of from 1 to 8 non-blank ENCINC characters 
provided the first character is nota zero, an asterisk, or a Ici parenthesis, 
Certain filetypes imply specific file characteristics to CMS, With system 

files, filetype is used to indicate whether the file resides in the nuclcus or in 

the Cisk-resident portion of CMS. Filetypes which bave specific implications 

for user files are given in Figure 2.1,0-A, The user may assign any of the 
filetypes in this figure to any file he wishes, but he should note that the commands 
which use these filetypes will not be successfully exccuted if the contents of the 
file are in any form other than that which the assigned filetype implics, 


Several of the CMS cornmands create files foe their own use on the user's 
permanent disk and assign specific filename-filetype combinations to these 
files. These filename-filelype combinations are listed below, and should 
not be assigned by the user; . 


filename 


filetype creating command 
INPUT FILE Wpyr 
INPUTI FILE EDIT 
(TEMI?) (FILE) COM BINIZ 
(DISK) (TYILE) DISK, TAPE 
SNOBOL TEMPFILE SNOWBALL, SPL 
LIS'TF EXEC LIS 
LOAD MAP LOAD, $, USE, REUSE 
(INPUT1) FILE SCRIPT 
(INPUT2) FILE SCRIPT 


In addition to the above, it should be noted that if a user file is created whose 
filename and filetype are identical to those of a file on the disk-resident portion 
of CMS, the user's file will be acceased in place of the system file. . Reasons 
for this are described in Section 3.0.0. 


The third portion of the identifier, filemode, consists of two characters, The 
first character is a letter indicating the disk area on which the file resides: "5" 
for system disk, "P" for permanent disk and "T" for texnporary disk. For 





assume that 


COMMANDS files with these 


Assemble, Hdit, Update 


‘ 


Tortran, Edit 
PLI, dit 
Spl4, Snowball 
Spl 


Seript 


‘Load, Use, Reuse, $, Txthib 


. 


Txilih, Global 


Loadinod, §$ 


Exec, $ 
Update 
Maclib, Global 


Maclib, Mdit 


Asscivble, PL 


Assemble, Fortran, Printf£, -PLI1 


Asscmblic 


Txtlib 
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contain information 


FILETYPE: in this 


SYSIN 


FORTRAN 
PL 
SNOVOL 
SPLi 
SCRIPLP 
TEXT 


PXTLYB 


MODULE 


RXEG. 
ULDATE 


MACLIB 


’ ASP360 


SYSUT4 


SYSUT2 ge Om, 


SYSUTS 


LISTING 


DIAG 


MAP 


FIGURE 2,1.0-A Filetype Implications 











PORMee 


Assembler jangaraje 
source code 


Fortran source code 
PL/) source code 
Snobol source code 
Spl4 source cade 


Script input 


Relocatable object code 


Relucezable objoet code 
library 


Non-releeateble object code 


Any coinbination cf Gas 
commands 


Update control and replace- 
ment card bnages 


Assembler lanjuase macro 
definition Jibrary 


Assembles language macre 


definitions 
' 


Assembler or PLT utility 
files 


Assembler or compiler 
source statements and 
corresponding machine 
code 


Assembler diagnostics 


Library map file ‘ 
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system files, the second character is always a "¥". For user 
files, the second character is a number from 1 to 6. These 
numbers have the following meanings, although the restrictions 
they :imply may not currently be implemented in all cases: 


lor 5 - file may be written or read. 


2 or 6 file is read-only. 


2 - file may be written or read but is erased 
after the first read. 


4 -~ file is read-only and is erased after the 
.first read. 


File Sizes 


Files stored on disk will be formatted into records 800 

bytes long. This formatting is handled internally by CMS, 

and is not controlled by the user. The maximum CMS file 

size, assuming that the user's assigned disk area can accom- 

modate it, is 12.848 million bytes, or 16,060 records. if 

a file consists of a source language program, a size limita- 
tion may be imposed by the language in which that program 

is written, and this size may be smaller than the 12.848 

million bytes allowed by CMS. 


Although there is no inherent limitation to the number of 
files a user may create, he is practically limited by the 
sizes of his permanent and temporary disk areas. When a 
user has filled either of these areas, a message to this 
effect will be typed out at his terminal, Refer to Section 
5.1.0 for recovery procedures which should be used in this 
case. 


A file is "accessed" when any portion of it is read or written 
Whenever a file is accessed for the first time by a CMS command 
or function, the file will be automatically opened. "Opening" 
in this case consists of making an entry into the user's 

active file table. CMS can open an unlimited number of files, 
but the language processors impose certain restrictions on 

this number. For example, only 30 data set reference 

numbers are currently defined in FORTRAN. CMS commands 

likely to access more than eight files will close files (i.e., 
remove their entries from the-active file table by executing — _ 
a FINIS command) as necessary. Also, all open files are 

closed by CMS after the successful execution of any CMS 
command. 
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second characiexs is a number from 4 to 6. Vhese movbers he following 
meanin is, although the restrictions the; intly may not cucrenfly be jippie- 
mented in all cases: 





dior 5 - file may be written or read. 
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is accessed for the Yrst time-by a CMS coramand or finction, the file iT be 
autorcatically opcawaél “Opening "in this case consists of makinp: an entry into 
the user's active Mle table. Only cight entries may exist in this table at any 
piven time. CNA commands Jikely to aecess more then cight files will close 
files (i. a, reifove their entvies from the active file table by exceuting a PINTS 
conunaid) as necessary. Ajso, all open files are closed by CMS after the suc- 
cessful execution of eny CMS conmand. The user docs uot need to be concerned 
with opaning and closing files-except when he desires to access more than eight 
disk files with one of his own programs. 
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2.2.¢ TERMINAL USAGE 


‘The ccenversaticnal ingut-cutfput device used to access the 
cP-S7/CKRS syster is referred tc as a "terminal" and is aperated hy a 
Yuser" who types informaticn that is tranewitted either by telephane 
dire or by fermanently-connected wiring to a cemputer, where the 
infcrmaticn is Leceived and pgrecessed hy the systen. In addition to 
Yec2iving and processing infcrmation, the system may cause infcrraticn 
tc be typed cut at the terminal. Infcrmaticn typed from the terminal 
keybcard by the user is called "input"; that typed out at the terminal 
ry the system cr ky a user fregrar is called "output", 


Fither cf fcur terminals tay he used to ‘access the CP~67/CH4S5 
eysten. These are (1) the IBM 2741 Cammunications Terminal as shown 
in fiyure 2.2.0-A, (2) the ITEM 1050 Lata. Communicaticrs Systen 
tecminal shewn in Figure 2,2.0-B, (3) the type 33 teletype terminal, 
ané (4) the type" 35 teletype terminal. Any of these tetminals may ke 
e¢ctnected to the ccmputer by direct~-wiring or Fy telephene line. If 
the terminal is net directly wired tc the ccmputer, a Data- Phone 
(Sitilar te that shown in Figure 2.2.0-C) will be placed near the 
terminal keybcard, and must be used to dial an installaticn-specified 
punter in crder te ‘establish a cenrecticn with the computer. The 
frecedure fer tsing a Cata- Fhone is descriked under ¢€P_ Login in 
Section 2.2.2. , 


° 
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2.2.4 TERMINAL CHARACTERISTICS 


2744 Characteristics 


The IBM 2741 Communications Termina) consists of an IBM Selectric type- 
writer mounted on a typewriter stand (sce Figure 2.2.0-A). The stand includes 
the electronic controls necded for communications, a cabinet for mounting a 
Data-Phone, a rack for mounting a roll of paper, and a working surface. ‘To be 
used with the CP/CGMS system, the 2744 should be equipped with the Transmit 
Interrupt special fcature and the Receive Interrupt RPQ, 


The 2744 has two modes of operation: communicate mode and Jocal inode. The 
mode of the terminal is controlled by the terminal mode switch, which is located 
on the left side of the typewriter stand. When in local mode, the terminal is dis- 
connected from the computer. It then functions as a typewriter only, and no infor- 
mation is transmitted or received. When in communicate mode, the terminal may 
be connected to the communications line to the computer. The power switch on the 
right side of the keybuard must be sct to ON before the terminal can operate in 
either communicate of local mode. The procedure for establishing conncctions 
with the computer and the terminal switch settings which should be used are 
discussed in this section under 2744 Initiation Procedures. Z 
Either of two 27441 keyboard configurations may be used in accessing the CP/CMS 
system. These are the PITC/EBCD configurations (shown in Figure 2.2. 1-A) and 
the standard Selectric configuration (shown in Figure 2.2. 4-B). On either keyboard 
the alphanumeric and special character keys, the space bar, power switch, the 
SHIFT, LOCK, TAB, tab CLR SET, and MAR REL keys all operate in the same. 
way as standard Selectric typewriter keys. 


On most 2741 terminals, the space bar, backspace, and hyphen/underline keys 
have the typamatic feature. If one of these keys is operated normally, the corres- 
ponding function occurs only once. If the key is pressed and held, the function Is 
repeated until the key is released. The following keys have special significance 
on the 2741 keyboard: : 


RETURN - The RETURN key is hit to signal the termination of 
each input line. When the RETURN key is hit, control ig trans- 
ferred to the system and the keyboard is locked until the system 
is ready to accept another input line. 


ATTN - The ATTN key is used to generate an attention interrupt. 

‘It may be hit at any time (since it is never locked out) and will 

cause the keyboard to be unlocked to accept an input line. Refer 

to Section 2.3.0 for a discussion of the transfer between environments 
which occurs when an attention interrupt is generated. 


The 2741 paper controls, such as the paper release lever, line-space lever, 
impression control lever, etc., are identical to the corresponding controls on 
an JBM Selectric typewriter and operate accordingly. 
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FIGURE 2,2,1-A IBM 2741 Keyboard (PT'TC/}BCD Configuration) 
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FIGURE 2.2.1-B IBM 2741 Keyboard (Standard Selectric Configuration) 
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Any invalid output character (one which cannot be typed by the terminal and 
for which no keyboard function, such as tab or carriage return, exists) will 
appear in terminal output as a vertical bar ()). For a further discussion of 
2741 Characteristics, refer toIBM Manual A24.3415, 


2744 Initiation Procedures 


The steps for readying the 2741 for use are described below. After these steps 
have been performed, proceed with the Login procedure described in Section 2.2.2. 


4. Set the terminal mode switch, located on the left side of the 
typewriter stand, to LCL. This insures that the terminal is dis- 
, connected from the computer. 


- 2, After making sure that the terminal is plugged in, turn the 
power on by pressing down on the ON portion of the terminal 
power switch at the right side of the keyboard. 


3. Check to sec that the margin stops, which are located on the 
typing guide just above the keyboard, are sct at the desired positions 
(normally 0 and 430). If so, proceed to Step 4. To reset a margin 
stop, push it in, move it to the desircd position, and release it. 


4, Check that the tabs are set at the desired intervals by tabbing 

an entire line using the TAB key. If the settings.are satisfactory, 
proceed to Step 5. Note that these tab settings do not govern the 
internal positioning of input characters. For a discussion of internal tab 
settings, refer to Section 3.4.6. lf the tabs are to be reset, position 
the typing element to the right margin, press and hold the CLR 
portion of the tab control key, and hit the RETURN key. This will 
clear all previous tab settings. New settings may be made by 

spacing the typing element to the desired location(s) and then pressing 
the SET portion of the tab control key. After tab stops have been 

set for the entixe line, hit the RETURN key to position the typing 
element at the left margin. 


5. Set the terminal mode switch, on the left side of the typewriter 
stand, to COM. The terminal is now ready for use as described in 
Section 2, 2.2. 
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1050 Characteristics 


The IBM 1050 terminal is composed of the 1051 Control Unit and a 1052 
Printer -Keyboard, as illustrated in Figure 2,2,0-B, The 1051 Control 

Unit includes the power supplies, printer code translator, data channel, 

and control circuitry needed for 1050 operation, To be used with the CP/CMS 
system, the 1051 should be equipped with the Time-Out Suppression special | 
feature and the Transmit Interrupt and Receive Interrupt RPQs. The 1052 
keyboard is similar in appearance to the standard IBM typewriter keyboard, 
Figures 2.2.1 C, D and E illustrate the 1050 paper controls, switch panel, 
and keyboard, The alphanumeric and special character keys, the $pace bar, 
the LOCK, SHIVT, and TAB keys and the paper controls operate in the same 
way as those on a standard IBM typewriter, The following keys are of special 
significance’on the 1052 keyboard. 


RETURN-if the Automatic EOB special feature is included on the 

terminal being used and if the EOB switch on the switch panel is set 

to AUTO, the RETURN key may be used to terminate an input line, 
Otherwise, (if the Automatic EOB special feature is not available:on 

the texminal heing used or if BOB on the switch pancl is set to MANUAL) | 
the character transmitted when the RETURN key is hit will be considered 
part of the input line. 


ALTN CODING -this key, when pressed and held while onc of the 

other keys is hit, will originate a single character code such as 
‘restore; bypass, reader stop, end of block (EOB), end of address (EOA), 
prefix, end of transaction (EOT), or cancel, Note that input lines 

from 1050 terminals not equipped with the automatic EOB special 

feature must be terminated by pressing the ALTN CODING key and 
holding it down while hitting the 5 key. This procedure will cause 

‘a carriage return at the terminal, , 


RESET LINE -hitting this key, at the left side of the keyboard, will 
cause an attnetion interrupt provided the terminal is equipped with 
the Transmit Interrupt special feature.) The RESET LINE key may 
be hit at anytime, since itis never locked out, and will cause the 
keyboard-to be unlocked to accept an input line. Refer to Section 
2.3, 0 for a discussion of the transfer between environments which 
occtirs when an attention interrupt is generated. 


RESEND-this key and its associated light (both located on the right 

of the keyboard) are used during block checking. The light comes 

on when an end-of-block character is sent by the terminal; it is ms 
turned off when receipt-is acknowledged by the system. If the light ) 
remains on, indicating an error, the RESEND key may be hit to ; 

turn off the light, and the previous input line may then be re-entered. 

While the light is on, no input will be accepted from the keyboard. 
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FIGURE 2.2.1-G IBM 1052 Paper Controls 
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IBM 1052 Switch Panel 











FIGURE 2.2,1-D 
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FIGURE 2,2,1-E IBM 1052 Keyboard 
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LINE FEED-this key causes the paper to move up one or two lines, 
according to the setting of the linc “epaee lever, without moving the 
typing element. 


DATA CHECK -this key should be hit to turn off the associated light 
(to its left) which comes on whenver a longitudinal or vertical redun- 
dancy checking error occurs or when power is turned on at the 
terminal, 


Any invalid output character (one which cannot be typed by the terminal and 

for which no keyboard function, such as tab or carriage return, exists) will 
appear in terminal output as a vertical bar (|). For further information on the 
characteristics and handJing of the 1050 terminal, refer to IBM Manual A24-3020 


1050 Initiation Procedures © 


The procedure for readying the 1050 for use are described below, When 


these steps have been performed, proceed with the Login proceduxe descrihed 
in Section 2.2.2. 


N 


1. After making sure that the terminal is plugged in, set the panel 
switches, shown in Figure 2.2.1-D. as follows: 


switch setting 
SYSTEM : ATTEND 
MASTER OF 
PRINTER] SEND REC 
PRINTER2 REC 
KEYBOARD SEND 
READERI . OFF 
READER2 OFF 
PUNCII1 ; OFF 
PUNCH2 OFF 
STOP CODE OFT 
AUTO FILL OFF | , 
PUNCH] NORMAL 
‘SYSTEM PROGRAM 
EO see below 
SYSTEM (up) 
TEST OFF 
SINGLE CY OFF 
RDR STOP OFF 


y; 


If an FOB switch appears on the terminal, it may be st to cither AUTO 
or MANUAL, If it is sct to AUTO, the RETURN key nay be used to 
terminate an input line. If the FOB switch is set to MANUAL or if it 
does not appear on the terminal, all input lines must be terminated by 
hitting the 5 key while the ALTN CODING key is pressed and held down. 
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2. Check to see that the margin stops~--the two blue indicators visible 
in the transparent strip jast below the switch panc]--are set as desired 
(normally at O and 130). If so, proceed to Step 3. To change margin 
setlings, set the PRINTER and KEYBOARD switches to WOME. Turn 
power’ on at the terminal by sctting the main-line switch shown in 
Figure 2.2.0-B to POWLR ON. Move the typing clement to the center 
of the line by spacing or tabbing. Turn power off at the terminal. Lift 
the top cover of the 1052 and tilt down the hinged portion of the front 
panel., Press the bluc margin indicators toward the back of the 1052 
and slide them to the new locations. Return the hinged pancl to its 
original position and close the top cover. 


3. Check the tab settings by setting PRISTER4 and KEYBOARD switches 

to HOME, turning; power on at the terminal, positioning the typing element 

at the left margin, and hitting the TAB key repeatedly. If the tab settings 

are satisfactory, proceed to step 4. Note that terminal tab settings do 

not govern internal positioning of input characters, For a discussion of internal 
_ tab settings refer to Section 3.1.6. If the tabs are to be resct, position 

the typing clement to the xight margin. Lift the tab setting switch, labcled 

CLR/SET, and hold it while hitting the RETURN key. This will clear all 

previous tab settings. New settings may be made by spacing the typing 

element to the desired location(s) and then pressing down on the tab setting 

switch, After tab stops have been set for the entire line, hit the RETURN 

key to position the typing clement at the left margin. Turn off power at 

the terminal. ; 


4. Reset the PRINIUR4 switch to SEND REC and the KEYBOARD switch 
to SEND, 


5. Turn the main-line switch to POWER ON and continue with the Login 
procedure discussed in Section 2.2.2. 
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Type 33 Teletyre Characteristics 
The KSR {Keykcard Send/Receive) mcdel cf the teletype type 33 


terginal is supported by CP-67. The type 33 KS includes a typewriter 
Keyboard, a ccertrol panel, a data phone, ccntrol circuitry fcr the 
teletype, and rell paper. The type 33 KSR keyboard contains all 
standard characters in the conventional arrangement aS well as a 
number of special symbols. Figure 2.2.1-F illustrates the hkeybcard 
and centrol panel, All alphaketic characters are capitals. The SHIFT 


key is used crly for typing the “uppershift" special characters, The. 
CrhL key (Control key) is used in conjuncticn with other keys: to 
ferfcrm epecial functions. Neither the SHIFT nor CTRI key is 


sclfi-locking; eéech must be depressed when used. 


In additicn to the standard keys the keytoard contains severa} 
nen- printing keys with special functicns. These function keys are as 
fcllcws: q 


LINE FERFE - this key generates a line-feed character and tcves 
the paper up one line without moving- the printing wechanisr. 
dhen the terminal ig used cffline, the LINE FRED key 

depressed after each line of typing to avoid over-printing cf the 
next line. 


RETURN - this key 1s the carriage return key and signifies the 


physical erd cf the input line. 


BRET - this key repeats the action of any key depressed, 
BREAK = this key generates an attention interrupt and 
intetrupts program executicn. After kreaking prograr executicn, 


the ERK-KLS kutten must ke depressed te unlock the keyboard, 


key is used in cenjuncticn with other keys to 
yertcrm special tunctions. The tah character (Centrecl-T) acts 
like the tab key cn the 2741. Centrol-l! acts like the backspace 
key cn the 2747. Control-¢ and Control-F produce an attenticn 
interrupt like BREAK if the teletyre is in input mode. Control-s 
(X-CFP) and Control-¥K act as FETOKN. Centrel-f (EOT) should not 
ke used ag it may discennéct the terminal. Contrel-G (hell), 
Control-Rk (tape), Centrel-1 (tafe), and all other Contra) 
characters are legitimate characters even thcugh they have no 
eguivaldent cn the 2741. 


CNTRL this 


FSC (ALT Y on some units) is not used by it 


gererates a legal character. 


CP-67 but 





should be 
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Inz centrél farel to the right 
tEclow the .teleptcre 
NOBMAL-FESTCKE know 
Ecllcws: 


of the keytroard contains six huttons 
dial and two lights, a button, and the 
above the dial. The buttcus and lights are as 


CRIG 


(Criginate) - this kuttcn obtains a dial tcne hefore 
dialing. The volume ccntrel cn the Ilcudspeaker (under the 
keykcard shelf to the right) should be turned up such that the 


Gial tone is audible. After ccnnection 
teen made, the vclume can te lowered. 


with the computer has 


CLE (Clear) - this 


typewriter. 


kutton when depressed 


ANS (Answer) - this Luttcn ig not used hy CF-67. 


TST (Test) -. this button is used for testing purgpeses cnly. 


i¢l (Local) - 
oftline usc. 


this buttcen turns cn the typewriter for local or 


EU2-RIS [Euzzer-Release) -~ this buttcn turns off the huzzer 
“that warns cf a lew farper supply. The light in the RUZ-R8LS 
kuttchn rete2ins on until the paper has been replenished. 


BPRK-RLS  (Freak-Kelease) - this buttcn unlocks the keykoard 


after fregran execution has been interrupted by the BREAK key. 


AEST - 


this light is net used by CE-67. 


AGERAL - SEFSIORE - this knob is set 
tne cabber, in which case the Know is twisted to the CUT-OF-SERV 
light. The knew is then set tc RESTORE and returned to NCKMAL: 
when the cperation has heen completed. 


tc NORMAL except to change 


QUT-CF-SERV (Cut-of-Service) - this light gocs cn when the 


Rotrgal- RESICKE knaw is pointed to it for ribben changing. 


Mest teletype units have a lcudspeakerc and a velume control know (VCL 
is turned 


lccated urder the keyboard shelf. 


increase the velune. 


The knob cleckwise to 





turns off the 
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Jne KSK (Keyboard Send/keceive) model cf the teletyre type 35 
terminal is supperted ky CP-67. The type 3& KSB, like the type 33 


a typeuriter keykoard, a control fanel, a_ data phone, 
well as roll paper. The type 35 has basically 
the tyre 33. The additional features of a type 


KSa, uwncludes 
-entrel circuitry, as 
ehe same features as 
35 are the tollcwing: 


hutton cperates as the LITRE 


LUC LF (LecalyLine Feed) - this 
FRED b It is used 


FLER button without generating a line-feed character. 
3leng with the LGC CR. 


returns the 
end-of-line 
line of 


(LecalyCarriage Return) - this buttcn 
Carrier as HETURN dces withcut generating an 
Character. LOC CR is normally used only tc continue a 
input to tke next line. 


Icc CR - 


LCC _ESE = {LogicalyRacksface) - this button generates a 
character Lut it has nc meaning with the KSk mcdel. 

PREAK - this kuttcn generates an attention _interrupt and 
interrupts pregran executicn. After execution has been 


interrupted, BEX-KLS and then the K ktuttons must he depressed te 


unlcck the keykoard. 


Kk  (Keyfoard)  - thie kuttcn unlocks the keyboard and sets the 


terminal fcr page cczy cnly. 


Yost Type 3S terminals have a vcluwe ccntrel know (SPKR VOL) for the 
levdgpeaker lecated to the right of the keyhoard. Turning the know 
cleckwise increases the volume. 


A ccelumn indicator at the upper right of the keytoard indicates the 
cclumn that hes just Leen printed. then the 1T0C CR key is used, no 
eni-ct-line ig recorded and the column indicator does not reset. 


A red light tc the right of the column indicater warns the user that 


tha carrier is apprcaching the right margin. 





ALi y 


sa 





Zeded LCGGING FRCCEDULES 


has secticn describes the procedures 
the terminal te Lecgin and te 


which must ke performed at 
terminate use of the 


Fet tne procedures cf Connecting a user to a multi-access system such 
as KAaX ocr APL, refer to Secticn 2.2.3, "Dialing a Uulti-Access 
Syetenr". Eefcre the facilities of the CP-67/CMS system are trade 


dvéeilaLjJe te a user, he must identify himself to the Centrel Progran 
ty giving hig userid and his fassvord (two identifiers which are 
astigned to hin at the time ke ig authcrized te use the system). This 
iuentificatiten greceidure is referred to as "CP Legin", When CP Legin 


is ccipleted, a ‘ccenscle tuncticn may te issued tc 


initialize CMS, ag 
jescriled kelcw. | 


cempleted his use .ef the system, he signals 
"logout" to the Contre] Proqrag, The period 
leqcut is referre? to as a "terminal sessicn". 


Yhen the user has 
this fact Ey issuing a 
between CE Legir “and CP 


After the terminal has keen readied for use” ag descriked -in 
secticn 2.2.1, the fclicwing precedure must te performed ir crder to 
gain access te the CP-67/CMS system. (Ncte that input may ke entered 
in @ither upper ¢ér lower case. Upper case is used helecw te indicate 


vocds which must be- typed as they are shewn; lower case indicates 

Li¢glds whese certents ay vary.) 
1. Farst, a communications line to the ccmputer must he 
€statlished. If the terminal is directly wired to the ccmyputer 
this igs autematic and ycu nay ~receed to Step 2. If the terminal 
is a teletype 33 or 35, depress the ORIG hutton, make sure the 
dial tone is audible, and then dial the installation specified 
number and proceed to Step 2; the ORIG kutten is lighted at this 


point - if the light gqccse cut during the terminal session, 
Legin precedure must ke repeated. Otherwise, a 
similar tc that sShewn in Figure 2.2.C-C will be 
terminal and should be used to estatlish a 
with the cenputer as ‘fcllews; After making sure that the pluq 
frer the TatazvPhone is connected to the wallyack, press 
tuttcn lakeled TALK, liit the receiver, and dial the 
installaticn-specirie?d numker. When a continuous tone is heard, 


the Cp 
Data- Phone 
placed near the 
commuunicaticn line 


frees the tutten labeled DATA ard replace the receiver. The DATA 
Euttcn ghetld now be lighted, and will renain lighted as long as 
the terminal cremains connected to the computer. If this light 


goer out at any fFeint during the 


terminal session, 
Frecedure oust be repeated. 


the CF Login 


@ The system will acknowledge that a communicaticn 
reen estallished ky typing cre cf the fcllcewing messages: 


line has 


CP/6H7 ONLINE XXXXNXXXXXX XK 


CP-67/CNS. system, 


the- 
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“up again, 


VO/UL/bOS 
2.2.2-2 Ay 
XYXXXXEXXXKX CE/67 CNIINE 
CP/67 ONLINE 


The first message will be typed if the terminal is a 1052 or 
2741 equipped with an FECD character set. If the seccnd.messaqe 
is typed, the 2741 hag a standard Selectric cr correspondence 
chaLtactcer set. In either case, the xxxxxxxxxxxx pertion cf the 
meseage ccrsists of meaningless characters and should be iqnored, 
[If the terninal is a teletype type 33 or 35, the third ressage is 
typed. 


3. At this point the system must be notified that scmecene wishes 
to use the terminal. Tec de this, hit the attenticn key once. Qn 
the teletype 33 or 35, hit EREAK and then PRK-RLS. ‘ 


4. dhe system will respond ty 
on a 2781 cre1052 ce waiting fcr 
or ky (2) 


either (1) unlocking the keyboard 
input cn the teletype 33 or 35, 
typing cne of the following messages: 


VAX NO. OF USERS EXCKEDED . aS 
If the keytoard unlocks or CP-67 waits fer input, preceed te Ster 


5. If the message is typed, the system is already servicing the 
faximun nember of users and the legin frocedure will he 
terminated. In this case wait fer a fer minutes and then try 


ayain ky returning tc Step 1. 


SHUTLCORN IN PROGRESS 
ce-€? is ir the process of heing 
return tc Step 1. 


taken down. When it is brought 


&. Identily ycurself te the system by typings 


JOGIN userid 
follcwed ky a carriage 
identificaticn. 


return, where “userid” is your user 


Oe The system will respond with cne cf the following messages: 


ENTER EFASSHOREL?: 


This messace indicates that ycur user identification has heen 
accepted. Ereceed to Step 7. 

FEFEAT PEOCELURE 
{i this nessace is tyyed, the werd "IOGIN" has heen entered 


is 


incerrectly. Return to Step 5 and retype the input line. 


USERID ON xxx 
BEEEAT PROCELCURE 
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2.2.2-3 “i 


This messace indicates that another user with the same userid is 
logged cn at the terminal whose address is xxx. You will not he 
able to legin with the same userid until the cther user has 
logged off. ; 


CSER NCT IN CIRECTCRY. 
FEFFAT PROCEDURE 


It this scessage is typed, an invalid useril has keen specified. 
Feturn te Step 5 and lcqin again. 


. 


7. ‘@Type ycour passwerd, fcllewed by a carriage return. If the 
z?4i tersiral is equipped with the Print Inhibit feature, the 
password wild ret tke typed at the terminal as the keys are hit. 
Ihe Print Inhiktit feature apfplies cnly to the typing of a 
Fassword. If tne terminal is a teletype 33 cr 35, three lines of 
Characters are cverprirted Eefore ycu are allowed to enter your 
passvord. 


&. At this time if there are any cards in the virtual cara 
‘reader or cutput fer the printer or punch, the message 

FILESs— xx RDK, xx PRT, xx PCH 
is typed... If the CF operator has set any log messages for the 
éay, they are typed alec. 


3. The system will respond with cne cf the following messages: 
FEACY AT xx.xx.XX ON XX/XX/XX 

where XX.xx.xx is the time cf day and xxyxx/xx is the date. This 
meesaye incicates that the fasswerd has bean accepted and the CP 
legin precedure is completed. The Contrel Pregram environnent 
has teen entered, ard any console functicn may be issued. To 
initialize CMS, proceed to Step 11. To initialize any other 
crerating system proceed tc Stef 10. 


EASSKORE INCORRECT. 
FEPFEAT PROCFLURE 


If this message is typed, an invalid passsord has been specified 
and the lccin procedure will be repeated. Return to Stef 5. 


10, At this peint in time, any cperating system can he leaded 
into the virtual machine. To load in CMS, go to Step 11. To 
lead in ancther cperating systen, issue the IP1 console function 
to CP-67 specifying the device from which the system is to 
loaded. Fer example, IPL 293 cer IPL CCC. If the device that is 
IPled contains an operating system, such as OS/36C, cf that 
cperating system and ycur tecwinal is effectively the operator's 
ecnscle. For information on running OS under CP-67, see OS/360 
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in a CP-G7 Virtual Machine, by Ce. I. Johnson, IBM Carbridge 
Scientific Center Repert 320-2035, Cambridge, Massachusetts, 
February 166%. 


Initializetion 


11. To initialize CMS, issue the following ccnsole functicn: 


IPL 190 
or 
TEL CMS 


followed Ly @ carriage return. This will cause a copy of the CS 
rucleus tc be brought intc ccre from disk. 


12. The message: 
CNS... VERSION xX.x . XX/XX/XX 


will be typed, and the keyhoard will te unlocked. The x.x is the 
versicn nunber and xx/xx/xx is the versicn date. The CMS Command 
environment will have centre] at this pcint, and any CKS command 
may be issued. 


when the veer has finighed using the syster and wishes to end his 
terrinal s¢ssicn, he should do so by legging out frem the Control 
Erccram. If the user is net already in the Centrel Progran 
environaent at the time:he wishes to legcut, he may enter this 
environment ty hitting the attenticn key ence. The keyboard will 
ke unlccked and the user should type 


ICGCUT 
follcwed ty a carriace return. The system will respond with 
LOGOFF AT xXo%XeXX ON XX/XX/ XK 


and the ccnnecticn to the cenputer will be lost. The logout 
frecedure is then completed and the user may turn power off at 
the terminal. 


{it the user desires to end his terminal sessicn Eut nct lose the 
connecticn with the ccmputer such that ancther user may loqin 
from the terminal, the user should type 


1CGOUT anything 


followed Ly a carriage return. The "anything" must be at least 
cne character ce any cembinaticr cf characters. The connection 
kith the computer is not lost and the CP-67 ONLINE message is 
typed out fer the next user tc lcgin, as in Step 2. 





2. 
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/CP/67 ONLINE 


The first! sessage will ke typed if the terminal is a 1052 or a 
2741 equiffed with an FECD character set. If the seccnd tessage 
is typed,| the 2741 has a standard Selectric or correspondence 
character; set. In either case, the xxxxxxxxxxxXx portion of the 
message cersists cf meaningless characters and should be iqnored, 
If the terrinal is a teletype type 33 or 35, the third nessage is 
typed. 


3. At thas point, CF-67 must ke notified that someone wishes tc 
use the terminal. To dc this, hit the attention key once. On 
the teletype 33 or 35, hit ERFAK and then ERK~-RLS. 


4. The system will respond Ly either (1) unlocking the keybcard 
cn a 2741: cr 1052 cr waiting fer input cn the teletype 33 or 35 
cr by (2): typing one of the following messayes: 


‘ PAX. NC. CF USERS EXCEEDED 
/ LCGGED CFF AT xx.xxXeXX ON XX/XX/XX 


It the keybeard unlccks and CP-67 waits fcr input, freceed to 
Step 5. If the message is typed, the system is already servicing 
the maxinun nembter of users and the dialing procedure will he 
tetminated. In this case wait for a few rinutes and then try 
again by returning to Step 1. 


. SHUTCOWN Ib ERCGRESS 
' LOGGEEL OFF AT xxexxXe¥X CN XX/XX/XKXe 


CP-67 ig in the fpreccss of being taken down, When it is 
breught up again, return to Step 1. 


Sa Specify the multi-access system to which you wish tec gain 
access ky, typing: 


_ TIAL system 
follewed ty a carriage return, where "system" js the userid of 
the multi-access system. 


6. The system will then respond with one of the fellecwing 
messages? 


+ ee econnectedese 


This mesgace indicates a cennection has been made between the 
terminal, and the multi-access system and the terminal is now 
under contre] cf that system. Cnly further responses will he 
these of | the multi-access system, as the user can net get te 
CP-67 tojiissue ccngole functicns. 


' ¢ystem ALL LINES BUSY 
| FREFAT EFOCELURE 


2.2.2-5 £722 rn  2.2.2.-6 


Po) 
There are no 2702 cr 27€3 lines available cn "systen", The lines 
may not ke available for any one of the three following reascns: 
27C2 or 2703 lines are not defined in the virtual machine; the 
virtval lires are not enabled by "system", cr all of the lines 


‘are in uSé. 


system NCT AVAILABLE 
FEEEAT ERCCELUBE 


The "systen" being DIALed is net legged in tc CP-67. 


system LINES NOT READY 
BEEEAT ERCCELUBE 


The “systen" has not issued an enakle for the 2702 or 2703 lines. 


system NC CIAL LINES 
FEEEAT PROCELURE 


fhe "systen" has no 27C2 or 2703 lines in its virtual trachine 
descrifticr. 


2s see eee re 


the terminal remains connected to "system" until one of the three 
following events cccur? 


(1) "system" issues a disable ‘for that terminal. This is 
usually brought atout by logging cut cf "“systen" in the 
ccrrect manner. . : 


cr 
(2) "system" issves the CE conscle function CFTACH, 
specitying the terminal address. 


cL 
(3) "system" Icgs cut cf, CP-67. 


When the terminal is disccnnected from "system", the 
fcllcving message is typed out: ‘ 
CE/EF LOGOUT 


The terminal can now ke used to login in CP-67 as in Section 
2.2.2 cr to dial intc a multi~access system aqaln. 
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2.2.3-1 : P 
Le gy session, Step i must ke repe2ated tril oe 


‘ a 
reas a) 


@ 


bo 
ye 
4 
HI 
o4 
Le) 
fo 
Pod 


Nulti-dcecss Systca 





* 2. tne syster will acknowledge that a coxmunicaticn 
Shis section ccscrikes th2 procedures which nust whe dinc tas becn established sy typing one of the 
perferwed te ceunact a aa tc a systes that provides Icaicitng ncssages: 
mudvi-tercinal facilitics, such as APL cr RAY. the 
nrecess Sf placirg a oes inte a nvulti-access systen is CE/ET CULINE>  XXXXXUXNNKKY 
rectnced vo “be Musa ingts: The gysten te fe <cleled- sate ANXM EK KKK AX nA ORLINE 
nuet be legged cn te CE-67, as in Section 2.2.2, with CE/GO7 CLINE 
sore 2702 or 2703 lines availatle and enabled befcre . : var 
tne coenneetion car ke sade. ‘When <the connection is She gisst wesseaga will ce typei if the terninal is a 
zace, €laling has been cerpleted and the tozninel is ief2 or a 274% equipped with an ELCD character sect. If 
tnhder the cortrol cf£ the system diated imce. the second message is tye ced, the 2741 has a standare 
conseguentiy, the user is. net known to CP-6€7 as a Selectric or cecrrespcerndence character set. m eLther 
regtlar "loggeé in" uscr Lut as a "dialeé" user. case, tho xxxxxxxxxxxx corticn cf the zressage censisis ‘ 
, ez seaningless chatacters and shoulda re ignasea: if 
the terminal is a teletype type 33 oar 35, the third 
RaeR thevuser has ccapleted hie: ese cf the nulti-access message “is typed. 
evsten, he should leg cut cf that eysten dn the 
éyproriate aannor; «hen that gulti-access systen issucs : : 
a "“gisehle" conmand for that terninal, the terrinal 3. At this foint, CP-67 «trset ba notified that sonaone 
vill be free fer ancther user to “login” to CE-67/CiS wisncs te vse the terminal. Ic de this, hit the 
er to "dial" a multi-access syster. attenticn key cnee. Cn the teletype 33 cr 35, Ait 
EREAK ané then DRK-RLS. 
e 
pisiilrs : 
“&. dhe svsten will reercnd by either (1) unlocking the 
Keyocard cn a 2764 or 1652 or waiting fcr input cn the 
hiter the tersinal kas been readied fer use as teletyze 33 cr 35 cr by (2) typing one of the follewing 
cescrited in Secticn 2.2.41, the follcvirg yrecedure ressages: : 
gust be perforsed tec gain access to a wnulti-access ; 
Syvsien. (Sote that input ray be entered in either BAX. 2O. CF USES EXCEEDED 
upper cr icver cases. Ursrer case is used below to : LCGGFD OFF RT xx.xx.xx ON ¥X/Xx/ XX 
indicate worés which aust be typed as they are shown; : : ; 
loser case indicates fields whese contents may vary.) DE the keytcard nlecks ard Cp-€7 waits fer input, 
. ; wrecees te Step 5. Tf the- saessage is typed, the systes 
: Bs @lueédy servicing the saxisur nunker of users and 
‘e First, 2 conununicetions line to the cesputer must tke cializg peccedure sill be terminated, In this case 
te estatiished. If the tersinal ais directly wired to weit fcr a fev ainutes and then try again by returning 
the corputer this is autcnatic and yeu ray preceed te to Step 1. 
Ster 2. If the tersinal is a teletype 33 or 35, 
Céerress the ORTG button, sake sure tte dial tere is ; SHUZDOUN IN ERCGRESS 
zucitie, end ther dial the installation specificd . LOGGED CFF AD Xx.x%.XK ON XX/XX/XX. , 
muncerc and proceed to Step 2, the GRIG buiten is : 
ligntec at this peint - ig the light gees ovt during CP-67 is in the grecess cf being taken dewne When it 
the tersinel session, Stés 14 must be repeated. is creught up again, return tc Step 1. : 
Cikexrvise, a Data-Phene sinilar to that shown in Figure 
2.2.0-C will ke placed near the terminal and should be z 
used to establish a conaunicaticn Jine with the f. Specify the mauiti-access systca to which you wish 
ecugttor we £ : after making sure that the sles t0 gai: acccss hy typing: 
Sten the Bete ne is coanectiad to the valigjack, press 
the cutceon lakeled Talk, lift the receiver, ané cial CIAL syste 
the inatallavtica specilled nusber. When a continuous 
.0ne@ iS hearé, press vas tuetten leseled DATA and fcllewvce ky @ carriage ratvrn, where "systez" dis the 
reziece tke receiver. The Data Better should nox be teerdé of the maati-access sysic.. 
Lighted, and will rcenain lighted es leag as the . 
excrinei rezains cennected te the cexputer. IZ this BT 
digit gees out-.at any point during the tersinal €. The systen will then ressond with one of the 


~~ ' 
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; . ; 2.2.3-3 ; Lb I7 
feollcvieg messages: . LG 5, 


al ois disconnected fren “systesn", 
€ is ; 


Yhon the termina 
: : tke fallowirg cessage typed outs 
es -connected... ' 





QO 
; 
_ 
my 
~ 
m 
oO 
@ 
© 
c 


: 51 
lnessage indicates a cennecticn has been nad 
ss ina a 


land the multi-acccss systen an 
wounder centrol cf that system. Chiy 

will be these of the ' multi-access | 
fér can not get to CP-67 to issue 


g 
serminal can now ke used to Jegin in CP-67 as 
ct 2.2.2 cr to dial inte a amvulti-access 





systea ALL LINES £0SY 
REPLAY PROCELUSE 





There: are neo 2762 cz 2703 lines availakle er "systen", 
tae lines nay net ke available for any cre ef the three | : 
tclicwing reascnse: 2702 cr 2703 lines are not defined , de 
, ain thé virtuct machine; the virtval lines are net os 
enall¢éé ty "systez", cr all cf the lines are in use. 
Systea xCT AVAILAELE 
REELAT PROCILURE 


« : . a : a : - 


the "systex" being DikLed is not logged in to CP-67. 


Sysien LINSS NCI SEADY 
REGE2T PROCIIUGRE 


cx" has net igssved an enable fer the 2702 or 


system NC LIAL LINES 

i REESAT PRCCELURE , 
The "Syston" has no 2702 cr 2703 lines in its virtual 
rachine description. 





ane dnéi renains ccnnected to "systena" until cne of ; 
the ree £clicwing events cccur: ’ , 
(3) "systen" issues 2a 6isatle for that terminal. ; 
This is usually brought about by logging out of . . 
Ssystcn" in the cerrect ranner. . ‘ ‘ 
oba 
eter" jesues .tha CP console functicn 
specifying the tarsinal address. 
tz 


(3) "systex” legs cut ef CP-é7. 
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2.2.4 GENERAL TYPING CCKVENTICHS as . Bie Os es 
Lg 
, F ; Z FCTTRAN AELF & AELE 
The follcwing typing ccnventions should te otserved when ertering all catece the £ite fs FORTRAN to be cempiled, leaded or 
input to ithe CP-67/CNS syster frem either a 2741, 1050, or a executed. The single input line to the ELIT environment - 
teletype 32 cr 35 terminal; 1 # L /BUFTy 4 C /FI/FFER/ 
will cause the characters BUFT to te lccated and changed to 
: RUFFEK. Tke line-end : i VEN 
a. Input nay te entered in either upper cr lower case. command [See ra era Character can be changed with the LINEND 
t. When tke keybcard is unlccked on the 2741 ox 1050, the he An output line on the 2741 and 105C may be a maxinum cf 130 


terminal is ready to accept input. The keyboard remains urlecked 
cn the teletype, therefcre a > (greater than sign) is typed at 
the left- ltand marqin when the teletype is ready tc accept input. 
If the user types tcc soon on the teletype, an interrupt may 
eccur whick will g~rekably cause the vser te go back to CP; if 
this happens, type BFGIK to return to where ycu were previously. 


characters. Any line lenger than 130 characters will cause 
cvcrprintirg at the right margin. On the teletypes, lines lenger 
than 72 characters in length are printed as two lines; the first 
line cuts cf£f after the 7ist character and an uparrew is printed 
at the end of the line to indicate continuation. 


° 


4. Illegal output characters will appear in terminal typeout as 
Spaces. ?r jllegal cutfut character is cne which cannot be typed 
and for which no keyboard functicn, such as a carriage return or 
a tak, can ke generated, 


c. The. character-delete symtol, @ , may be used tc delete the 
Freceding character in the input line. n character-deletea 
symtcols Gelete the freceding n characters in the input line and 
themselves. Exception: this feature does not aprly with the 
K-level ccnmanés or the RT cCcmrmand. The character delete symbol 


Cop he PONS rated Oy Ane CARERS E comand j- Cne cr more blanks are used to delimit the fields cf an input 


line tc the CMS ccmmand cnvircrnrent. 


J. The lire-deletc symrbcl, which is the ¢@ on the 2741 or 1059 
and the shift Kk (left tracket) on the teletype, may Ee used to 
éclete al] characters in the current input line and itself. A 
line-delete symbol (¢) cannct be deleted by a character-delete 
syubcl (a). Exception: this feature does net arfrfly with the 
K~level ccnrands cr the RT ccmmand. The line-delete symbol can he 
tedefined Ey the CHARCDEF ccmmand. 


e. An ingrt line may te a maximum of 130 characters in length. 
Any line lcncgec thar 130 characters - including delete symbols, 
btilanks, ard the tah character - will be truncated to 130 
characters. On the teletype 33, an input line can cnly contain a 
maximuz cf 72 characters. : 


f. An input line frem the 2741 cr teletype is terminated hy 
hitting the KETURN key. To terminate an input line fren the 
1050, kit the 5 key while hclding down the ALTN CODING key unless 
the 1050 is equipped with the Autcmatic ECB special feature. TE£ 
this special feature is availakle and the FOR panel switch is set 
to AUTO, irput lines may te terminated by hitting the RFTURN key. 


ge. Input lines can contain a nurtec cf logical input lines which 
are Separated by lire-erd character (the # sign). Fach call to 
read a line from the terminal will return a logical input line. 
Sutseguent calls te read a line frem the terminal will return the 
Icyical ingut line which was typed followirg the previcus legical 
ingut line. Fer example, the single input line - 





AD 


tm 


‘ ‘date 
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oS 2.3.0-1 | 
SMTA a, 
ATTENTICN INTERRUPT LP Sy eae GE 7 


After baking a phone ccnnecticr with the ccmputer and the message 


'CE/67 Cnlinet is) printed, an attention causes the CP login 
frocedure, to begin cr the dialing of a rulti-access systen to 
regin. 


interrupted (stepped) and the terminal 
readied fcr irput at any time by pressing the attention key 
(marked AITIN) cn a 2741, hitting the Reset button on a 1050, or 
the ERFAK key cn the teletype 33 cr 35. This causes control to 
fass to CE provided that the Control Pregram was not already in 
control. CE ccnecle functions can then te issued. 


The usertis machine may ke 


After oa Trevious attention (pressing 
control tc pass frer CMS te 


the ATTN key) causing 
CP, a subsequent attenticn will pass 
control ‘back to CMS. If CMS previously had contre] and was 
reading a line frem the terminal, i.e., the keyboard vas 
vniccked, the CYS program will be restartecé and the keykoard will 
te unleckeé acain. If CMS previously had centrol and was aot 
reading a line from the terminal, ‘i.ses«, the keyboard was lccked, 
the interreupticn pertits a single line of input to ke entered and 


stacked. f£tacked lines ch input will be used on successive calls 
to read a line from the torminal until there are no rere stacked 
lines. ‘Irput will then be taken directly from the terminal. 
After a ‘line to be stacked'is entered, C4#S continues from the 


environment which was last interrupted, 


Any number of lines may 
be input ard stacked in this way. 


dJhen entering twe attenticns te the system te stack input, thea 
ATIX keyistould net be pressed the second time until the keybcard 
has keen; unlocked in respense tc the first attention. If the 
second attenticn is entered befcre the keyboard’ is unlocked, it 
will be icnored. 





ENVIRCHPERT CCHVENTICHS 


Each input line which is typed at the terminal ky a user is 
transmitted tc the CP/CMS system where it is processed (examined 
and accepted or rejected) ky a given routine. The particular 
routine ty which input will be processed is determined by which 
pcrticn cf the system has control at the time the input line is 
entered. Each ¢erticn of the system tc which input may be 
entered corstitutes a unique environment, and cnly a_ subset of 
all possitle input is acceptable tc any given environment. the 
fcllcwing are the environments of the CP/CKS systen; 


Centre] Frogram cnvircnrent 
CMS Command chvironment 

Cekucg cnvirecnment 

Edit environment a 
Jnput environment 

Script Edit environment 
Script Input envircnment 

Eche environment 


x 


In additicr 
entered te 


tc these eight specific environments, input may be 
any cther executing program ‘hich expects terminal 
input. These cther input precessing preqrams are grouped into a 
ninth, "Fregram" environment in which the acceptatility of an 
input line ig deterwined ky the executing pregram. 


With the excepticn cf the Pregram envirenment, the input 
frecessing reutines fall into three main categories: input is 
received ty either the Ccntrol Program (CP envircnment), a 
contral CHS service reutine ‘(CMS Cemrani environment), or a 
farticular CMS command (Dekuq, Edit, Input, Script, Edit, Script 
Input, and Eche envircrwents).. Input lines which are acceptable 
to the CE environment are referred to as "console functicns" 
since fer the most part’ they simulate functions that can he 
perfermed at a 360 console. Input to the CMS Cosnand environment 
may Ee any CNS “cenmand", 


A certain number of the CNS ccmmands carse environments of their 
cwh te be entered, These are the DEBUG, EDIT, SCRIPT, and ECHO 
commands. Lines acceptable to the environments of these ccrmands 
ace referred tc as “recuests" cr nerely "input", depending on the 
farticular environment which is entered then the ccmmand is 
issued. The ELIT and SCRIPT commands will cause either of two 
environments to be entered: If either ccmmand is issued fer a 
file which already exists, the apperepriate editing environment 
Bdit or Script Edit) will be entered, allowing the ccntents of 
the existirg file te ke examined and nodified. If an FOIT or 
SCRIPT command is issued for a. file which does net currently 
exist, the appropriate inpet ervircnrent (Input or Script Input) 
will be entered, allowing the file to ke created. Both the Input 
and Script Input envircnments will accept any input tyred at the 
terminal, and this input will kEecome a part of the file being. 
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environment will alse accept 
as output 


The Echo 
repedt that line 


created. 
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“fer 4 syncnym or akkreviaticn, the typed command is internally 
expanied te the criqinal CES command name and the akcve searching 


sequence is pertcrmed again. 


: . “fl ; 
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2.9.0 C¥S CCMMANETS 


Tne CMS ¢ccomands provide user facilties fcr file maintenance and ; 
aarifulation, ¢»ecuticn control, debugging, lanquage precessing, and Ihis meane that the user is able te substitute his own prograns 
vacicus utility cferaticns. ter dagk-resident commands by creating a ccre-image file of the 

Eroytam and assigning it a trilename identical to that of the command 
: : it is tc replace. This alsc means that any user file. in core-image 

These commends may te issued frem the terminal or called from. ' tera way be called directly as a command, by issuing the filenaye {and 
user pregrare. Each ccrnand consists of a ccrmand name and its any operands ce parameters expected by the program) as an input line 
cpicanids, if ary. Abbreviaticns have been established which allow the tc the CES Command environment. 

Li2n to specify only the number of characters of each cormand coprand 
nate which reérve te uniguely identify that ccemmands. In the case of 
ccitards «with the same leading characters, tke more ccrrenly used \ brief description of each CMS command is given in Appendix A. 
command kas Leer assigned the sherter abbreviation. "L", for example, Any invalid cennand, i.e., cne whese command fregram dces ret reside 


ae ts abbreviation for the LISTF command, and "LO" for LOAD. Any in the CHS nucleus oc transient-area and fer which a core-image module 
numcer of additional characters beycnd the mininum may be specified in cannct he lecated, will te ignored and the nessage "INVALID CMS 


tle conrand ade. For this reason, “LO", "LOA", and "LOAT" all CCYMAND" will ke typed at the terminal. Cferand Eeecessing is handled 
7 } ¥ ODE 3 : '" m4 hy inj a : ‘ sf 3 
identify the FECAL ccrnand whereas LGADK" is the minimum abbreviation ty the individtal ccmmand programs and these programs previde all 
ter the ICARrCD command. If the user desires to change the messages dealing with ccmnand format. 

atkreviations cr use synenyns, the SYN ccmmand can be used to create 


tke ccunand nanes. 


\ format ard usage cf each cf the CMS cemnands are descrihed in 
detail in the fcllcwing sections, Examples of ccumand usage and each 
respcorse and errer message which may be issued are alsc given. A 
respensc is any message typed at the terminal tc indicate the cause of 
an error return cede in register 15, which will terminate command 
executicn. .All responses and error messages which may ke issued 
appeac in alpkaletical crder ain Appendix C, with references to the 
secticn(s) where they are described further. 


Ihe comudnué name and each cf its operands must be sefarated by 
cneé cr acre tlerks, The crerands which are valid for each ccmmand are 
dazcussed under the Format section cf. each ccmmand description and 
alec in Appendix FE. Each ccuomard must be specified in a single line { 
cl irput. The carriage return siqnals the end ef a typical input 
line. To stack multiple CMS ccrnands cn one line of input, use the 
dire-end character, which is defined as the &# ., The line-end 
character can Le redefined via the LINEND cemmand. CMS commands cannot 
ke certinued ¢nte additicnal lines. 


Fach CMS. ccmrtand has a ccrrespending command frogram which 
resides either in the nucleve, in a transient area, or in the 
disk-resident, fortion. of CMS. This program is identified by the 
ccarand werd ‘cr its akkreviaticn, which ig issued as the left-most 
irput cr the ccnmand line. 


then a céemnand is issueu, the directories of the transient area 
ccomands and then the nucleus-resident ccmmands are searched for the 
corctesponding .ccwmand fregran. If the progran is located in one of 
the Jirectories, it is assumed to be in ccre, and contre] will be 
transferred te it directly by a BALR instructicn. If not, a LCADMOD 
will be issued to briny the command program into core. In attenrpting 
to lecate this pregram cn disk, the user's permanent and temporary 
directories and the system directory are searched, in that crder, for 
a file with the specified filenane (ccmwand name) and a. filetype of 
tGDULE, indicdting that the file is in core-image forn, The first 
file found whict nects these recuirements will] be loaded inte core ana 
certrcl will ke transierred te it. If the MOLUIE file is not found, a 
check i8 nade -ftcr abbreviations ky checking fer user-defined synonyns 
(sec SYN) andittern standard systen ahkbreviaticns; if a match is found 

! 

! 
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3.1.0 FILE CREATION, MAINTENANCE, AND MANIPULATION 


File Creation 


Facilities are available in CMS for the handling of disk, card, and tape 
files, Most of the CMS commands, however, require that the files they 
access be stored on disk. This means that card and tape files must be 
transferred to disk before many of the commands can be issucd for them. 


Disk files can be created from terminal, card, or magnetic tape input, 
or from other disk files. Issuing either the EDIT or SCRIPT EDIT 
commands for a disk file which does not currently exist will allow the 
specified file to be created from terminal input, EDIT creates card- 
image files; SCRIPT EDIT accepts any terminal input up to 120 char- 
acters in length. To create a disk file from card input, the OFF-LINE 
READ or DISK LOAD commands may be used, OFFLINE READ accepts 
card input in any format. DISK LOA) accepts only input in the CMS card 
format. The DUMPREST and TAPE LOAD commands create disk files 
from magnetic tape input, DUMPREST restores the entire tape contents 

“to the user's permanent disk area, whercas TAPE LOAD may be used to 
transfer one or more specific files to disk. The MACLIB GEN and 
TXTLIB GEN commands create macro and text library files on disk 
using the contents of existing disk files. The TXTLIB PRINT command 
will create a file containing the entry points of the specified text library. 
Other commands which create disk files from disk input are discussed 
under File Manipulation. 


Card files are created in CMS by requesting that the contents of disk 

files be punched out, The OFFLINE PUNCH command will punch out 

any disk file whose records are 80 characters or Jess in length. DISK 
DUMP will punch any disk file onto cards, but will firzc convert its contents 
into CMS card format, 


Two of the commands, TAPE DUMP and DUMPREST, cause tape files to 
be created from disk files. TAPE DUMP copies _ single disk file to tape, 
DUMPREST will copy the contents of the user’s entire permanent disk 
area to tape. 


File Maintenance 


Several commands provide facilities for maintaining disk files. UPDATE, 
EDIT, and SCRIPT EDIT allow any portion of an existing file to be changed, 
deleted, or added to. UPDATE processes the existing file against an 

update file, also stored on disk. Both EDIT and SCRIPT EDIT allow the 
contents of an existing disk file to be changed from the terminal. To 
change the identifier of a disk file without changing its contents, the ALTER 


1 
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command may be used. Additions to existing macro and text library 
files are made using the MACLIB ADD and TXTLIB ADD commands, 
respectively. A file or group of files can be deleted from disk by issuing 
the ERASE command. The FINIS command must be issued by any user 
program which accesses more than eight disk files, and CLOSIO is 

uscd to signal the completion of output to the card punch or printer 

from a user program, 


. 


File Manipulation 


CMS file manipulation consists of copying, combining, moving, spliting, 
and listing disk files. To copy a disk file, the EDIT or COMBINE 
commands can be used. COMBINE also will create a new disk file from 
the contents of two or more existing disk files and may be used to transfer 
a file between the permanent and temporary disk areas. The SPLIT 
command creates a new disk file composed of the specificd portions of 

an existing disk file ox files. 


LISTF, PRINTF, MACLIB LIST, and TXTLIB LIST cause file information to be 


typed at the terminal, The LISTF command will type out the identifiers and sizes 
of any or all files stored on the user and system disk areas. PRINTF types out 
all or the specified part of a disk file. The MACLIB LIST and TXTLIB LIST 
commands type out the directories of the specified library files, 


To print the contents of a disk file on the offline printer, the OFFLINE 
PRINT or OFFLINE PRINTCC commands can be issued, OFFLINE 
PRINT will print the file with single spacing and CMS headings, whereas 
the PRINTCC version will use the first character of cach record as a 
printer carriage control character, 


‘ ; 
wer 
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3.1.1. ALTER 5 


' 


Tne ALTE connand changes the name, type, OF mode number of user 


“files. 

Fcrmat:. 
! 1 | 
] ALTER | cin cit cfn nin nft nfm | 
! AL I s * * * 1 
I | I 


ofn icft cfm is the criginal filename, filetype, 
and filemcde, 


nin i nft nfm is the new tilerane, filetype, and 
filemcde. 


Ihe name, type, OF mode number of any file on the persanent or 
temporary ¢isk may be changed with the ALTER command. All fields 
ct the ccunand must be specified. Any field not changed may be 
represented by an * in the nc file designaticn. If the mode 
numker ig not changed, the original mode may be represented by an 
» 1 


Notes: 


ae ALTE dces nct move files between disks. The mode letter, P 
cL T, may not te chanyed. See the COMBINE ccmmand. 


De “ALLER may not ke used for files on the system (SY) disk, 
besEenses} 


ee: ALTER gives nce resgpense except the Ready wmwessage, cr an error 
message anc code. 


Exaggles: 





05/01/69 
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2. ALTER BEN SYSIN ES ERCG3 SYSIN P2 


The tile formerly called BEN is now referenced by the filename 
ENuGG3, ané is read-cnrly instead of read-cr-write. 


rk. ALTER JBS LISTING * JIRVEL3 * * 


The LISTING file fren an agsemkly of JBS is now referenced by the 
filename JIEVEL3. 


SSS MS wee KRISS 


E (60001) OLB FILE XCT FCUND 
The file te ke re-designated is net in the file directory. 
Checx the spelling of the filenare and tyre. 


£(0C002) NEW FILE ALRRALY EXISTS 


A file with the new name, type, and ode already exists. 
Chance cre cf the fields cf the new designation. rf 


concatenation with an existing file is desired, use the 
COMBINE ccmmand. 


BE (CcCCC3) OLE NODE ILLEGAL : 
The criginal mode specified dces net begin with P cr T, or 
dees ret end with a numher frem 1.tc €. 


EB (caCO04) NC CHANGES MALE 
The new Gesicnaticn specified is the same as the original 
desigraticn. 


£(CO005) . LILEGAL MCLEE CHANGE 
An attempt was made te change the mode letter. ALTER does 
net. meve files ketween disks. See the COMBINE ccmmand. "3 


E(COCOG) NEW MODE ILLEGAL 
The new mcde specified does not begin with P cr T, oF the 
mode rurker ig net ketween 1 and &. 


&(CCCO7) INSUFFICIENT EAKANETEFS 
A nane, type, ard mede were net specitied fer both files. 


9-15-67 


a 3,1,2-1 ; ee 
| CLOSIO . CLOSIO 8 
3.1.2 CLOSIO : 
Example: 
Purpose: 
: a. CLOSIO PRINTER READER 


Spooling areas assigned to the user for the printer and cardreader 
are closed. The reader area is erased. The printer file is queued 


for actual output. 


CLOSIO notifies CP/67 that I/O operations to an offline unit 
record device are complete. a 


Format: 


7 . ; Error Messages: 


(“cto [READER] [PRINTER] [PUNCH] None. 
' 
4 


CLO 


i i a ee ee ee dd ad 


Usage? : -, e 


CLOSIO is normally used as a supervisor-supplied function within 
: programs written in assembly language. However, it may br used 
-: ; as a command in cases where user-written programs including unit 
: record I/O routines terminate abnormally or do not include a call to 
CLOSIO. 


CLOSIO notifies CP/67 of an end-of-file condition for the devices 
specified, Any combination of the three devices may be specified 
with the command, Undefined devices are ignored. When CP/67 
detects the cnd-of-file condition, the disk spooling area assigned 
to the user for the specified device is closed, Printer and _card- 
punch files are queued for actual output, Cardreader input files 

are erased, — - 


All CMS unit record commands (OFFLINE, DISK, DUMP), whether 


issued from the terminal or called from within a program, have 
already performed a CLOSIO when control is returned to the issuer, 


Notes: ‘ 
a. CLOSIO is not used after CMS I/O commands. : 


b. CP/67 assumes CLOSIO for all unit record devices when 
the user logs out. 


c. CP/67 interprets any invalid CCW as a CLOSIO for the device 
' to which it is addressed. 


Responses: 
None. . , ee, 





522 
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CLOSIO 


3.1.2CLOS10 | 


Additional Notes: 


1. 


CLOSIC is penerally called to signal the end of an offline 
operation by sending an end-of-file condition to CF. When 

CP detects the end-of-file condition, the disk spooling areas 
are closed enabling the printer or card punch files to be 
qudued for actual output. 

If jit is desired to insure that.a number of offline punch or 
print files are output together, the CLOSIO function can be 
digabled by the following command: 


: . 
CLOSTG POUNCE ; OFF 


PRINTE 


After a number of offline punch or print files have been output, 


the CLOSIO function can be re-enabled by the following command: 


CLOSIO (puncn 
PRINTER 


In this way offline output can be collected before it is 
actually output to the physical device. 
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COMBINE 
3.1.3 COMBINE 
Purpose: 


The COMBINE command joins two or more disk files into a single 
file, moves files between disks, and changes file designations, 


Format: 


Ce ee ee ee ee SS eh Oe Oe sme ae mia 


eoraas Hs nft nfm ofn) oft] ofml ... ofmN oftN ofmN ! 
KOC 


are the filename, filetype, and filemode of 
the file to be created. 


nfn nft nfm 


are the filename, filetype, and filemode of 
existing file(s) to be included in the new file. 


ofn oft ofm 


Usage: 


The file to be created and each of the included files must be specified 
by filename, filetype, and filemode. Input files must have the same 
record format (fixed or variable length), Input files of fixed length 
records must have the same record length, Any number of input files 
can be included in the new file, in the order named, but the command 
must not exceed a single input line. 


The output file will be created on the permanent or temporary disk, 
according to the mode letter of the new file, Input files may be on 
any disk. 


If the new filename, filetype, and filemode are those of an existing file, 
the old file will be erased when the new file is created, The old file 
may be among the input files, 


"Notes: 


a. Files may not be capied to the system (SY) disk, 
b. As the input files are processed, a temporary work file 


"(TEMP) (FILE) mm", where "mm!" is the specified mode of the 
output file, is created. When processing is completed, this file is 
given the designation specified for the output file. If an error occurs 
such that input files are destroyed, records can be retrieved from 
this work file. i 
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Responses: 
None. 
Examples: 
ae COMBINE FILE DAO] P3 TST1 FILE P5 TST2 FILE P5 


The file "FILE DAO] P3''is created on the permanent disk, containing 
all the records of TST1, followed by the records of TST2. TST1 and 
TST2 are not changed. , 


bi. COMBINE JOBS EXEC T5 JOBS EXEC P5 
A copy of the permanent disk file JOBS is made on the temporary disk, 


Ce COMBINE JOBA FORTRAN P5 JOBA FORTRAN P5 SUBR1 FORTRAN P5 


The file SUBR1 is appended to a copy of JOBA, and the new file replaces 
_the original TOBA. ; 


Error Messages: 


(00001) FILE "filename filetype filemode" NOT FOUND. 
The file specified in the message was not found, Files remain 
‘as they were before the command, 


E(00002) DISK ERROR WHILE READING, 
An I/O error occurred, or there is insufficient core space for 
buffers, 


£ (00003) NISK ERROR WHILE WRITING. 
An J/O error occurred, or the user's allotted disk space is 
filled, 


E(00005) ERROR IN NAME, TYPE, OR MODE OF OUTPUT FILE. 
Correct the designation of the output file. 
E£(00010) CORRECT FORM IS: COMBINE Nl Tl Mi N2 T2 M2... 
WHERE Nl, Tl, Ml ARE THE NAME, TYPE, AND MODE 
. OF THE FILE TO BE CREATED. 
AND N2 T2 M2,ETC. ARE THE FILES TO BE COMBINED. 
The command format was incorrect, Files were not changed. 


F(00011) MODE SPECIFIED FOR OUTPUT FILE IS ILLEGAL, 
Correct the mode specification of the output file. If the first 
input file had mode number 3 or 4, it has been erased. 

F(00012) ATTEMPT TO WRITE OUTPUT FILE ON SYSTEM DISK 

ILLEGAL. 
The system (SY) disk is read-only. 








5S SG 
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E(00013) ATTEMPT TO COMBINE FIXED AND VARIABLE LENGTH FILES. 
The input files must all have the same record format. 
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pIskK 577 
3.1.4 DISK 
Purpose: 


The DISK coimmand punches specified permanent disk files on 
cards in a special format, and can reload chess card files 
onto disk storage. 


Format: . A 


frotteaporctcs: to ne ae me om eae ee ee ne Os a me ee Ma Nae Oe ee Oh me Ome Oke ee Ome 


DSH ean filename filetype ee ! 
Li 


7 DI OAD 
[ peel Pewee eS eee oS sceees eee keenest 
DUMP specifies a file is to-be 
. punched out. 


filename filetype filemode specify the file to be punched. 


specifies that one or more 
card files are to be read and 
Saved on the user's permanent 


. LOAD 


disk. 
The DISK card format is: 

H columns { content H 
fo eet ono! Leite ote oo el ta eee! 1 
i \ 

i 1 lea 12-2-9 punch { 
t 2-4 4 CMS { 
' 5 | blank, or N for EOF |] 
i 6-55 : file data ‘ 
! 56-57  « blank t 
| 58-76 | filename, type, mode | 
: 77-80 | sequence number H 


Usage: 


For a DISK DUMP operation, filename, filetype, and filemode 
must be specified. Only one file is punched out by a command, 
The file may have either fixed or variable length records, but 
must be on the permanent (mode P) disk. After all data is 
transferred, and end-of-file card is punched with an 'N' in 
colunn' 5. This card contains directory information, and must 
remain in the deck. ‘The original disk file is retained, wnless 
the mode is delete-after-reading. 
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The DISK LOAD operation will read any number of deck punched by~ 
DISK DUMP, File designations are obtained from the card stream, 
and may not be specified with the command. Any existing file 
with the same designation as one of those in the card stream 

is erased and replaced. 


Files to be loaded by a DISK LOAD command must be read by CP67 

as a Single deck before the command is issued. An identification 
card with CP67USERID in columns 1-10 and the user's identification 
starting in column 13 must precede the deck. 


Notes: 


a.. Data is punched in Extended BCD Card Code, 
$ r 
b. Each file punched out is preceded by a CP67 identification 
card containing the USERID. This card must be removed 
before reading the deck. 


Responses: 


a. DISK DUMP gives no response except the Ready message. 
b. filename filetype filemode LOADED. 
DISK LOAD gives this response for each file encountered in the 


input deck. The Ready message is typed after transfer is 
completed. ; 


Examples: 


a. DISK DUMP PROCS TXTLIB P5 


The specified file is punched out. Each card contains CMS in 
columns 2-4, file data in columns 6-55, and the characters 
PROCS TXTLIB P5 


in columns 58-76. 
columns 77-80. 


The cards are sequenced 0001, 0002, etc., in 
The last card contains an 'N' in column 5. 


b. DISK LOAD 


If the deck produced in the previous example has been read 

by CP67, the disk file PROCS TXTLIB P5 is erased. A new file 

is created with the data on the cards, and receives the designation 
PROCS TXTLIB P5. The following response is typed: 


PROCS TXLLIB P5 LOADED. 


The Ready message will then be issued to indicate completion. 





Nee! 
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Error Messages: 3.1.5 DUMPREST 
E(06001) CORRECT FORM IS: Purpose: 


"DISK DUMP" FILENAME FILETYPE FILEMODE 
OR "DISK LOAD”. 


The format of the command was incorrect. No cards were 
punched or read. Issue the command again. 

E (00002) FATAL PUNCH ERROR. 
Indicates an I/O error on the card punch, This message 
should never occur under CP67. Notify the responsible 
system programmer. 

E(00003) FATAL DISK ERROR. ‘ 
An I/O error on the disk occurred. A DISK DUMP operation 
may be retried. For a DISK LOAD operation, notify the 
operator to enter the card deck again’ before retrying 
the command. If the error recurs, notify the operator. 

E (00004) FATAL READER ERROR. 
Indicates an I/O error on the card reader. This message 
should never occur under CP67, Notify the responsible 
system programmer. ; 

EB (00005) ILLEGAL CARD IN DISK LOAD DECK. 
A card was encountered in the input to DISK LOAD that was 
not punched by DISK DUMP. A CP67 output identification 
card may have been left in the deck, or the wrong dack 
may have been read. The deck being read at the time of 
the error has been flushed, and will have to be re-read 
before retrying the command. No permanent file has been 
created. 

E(00006) END CARD MISSING FROM DISK LOAD DECK, 

Physical end-of-data for a DISK LOAD was encountered 

without reading the end-of-file card ('N' in column 5). 

The file created on disk does not have the correct 

designation. It may be accessed under (DISK) (TFILE) P3. 


Note that the mode is delete~after-reading, so an ALTER 
or COMBINE must be issued before inspecting the file. 





DUMPREST dumps the contents of the user's permanent disk onto 
tape, and can reload a disk from such a tape. 


Format: 


eee ee een cee ow in es me 


T ee 
| {DUMPREST} | 


Oe tet ed — 


, 


A message is typed requesting one of the following replies: 


DUMP 

> 

RESTORE specifies the permanent disk is to be 

R ; formatted, and contents of the mcunted 
tape are to be copied onto it. 


specifics the contents of the permanent 
disk are to be copied to tape. , 


The user's tape must be mounted at virtual device address 181 
before the command is issued. The disk address is always virtual 
191. For both DUMP and RESTORE operations, the command positions 
the tape at the load point with a REWIND. 


In the DUMP operation, data on the permanent disk is copied to 
the tape a track a time, including all directories and pointers. 
A RESTORE operation copies these records back to a disk in 
exactly the same locations. The disk is automatically set to 
CMS format, so a new or different disk pack may be used. 


a. RESTORE may not be valid if the location of the user's 
virtual disk 191 has been redefined since the DUMP operation. 


Responses: 
a. SPECIFY 'DUMP' OR 'RESTORE!: 


This message is typed, without a carriage return, aS soon as 
the command is issucd. When the keyboard unlocks, enter 
DUMP or RESTORE, or just D or R, to specify the operation. 

A reply error causes the response to be repeated. 


db. DUMP/RESTORE MOVED nnn CYLINDERS. 
THERE WERE non RECOVERABLE TAPE ERRORS. 


This message is typed at the completion of the requested transfer. 
If the number of cylinders specified is not equal to the size of the 
virtual disk, an irrecoverable I/O error caused early termination. 
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Examples: 


a. DUMPREST ! 
SPECIFY "DUMP' OR 'RESTORE': D 
DUMP/RESTORE MOVED 005 CYLINDERS, 
THERE WERE 099 RECOVERABLE TAPE ERRORS, 


The contents jof the user's permanent disk have been dumped 
to tape. Novierrors occurred. 


b. DUMPREST . 
' SPECIFY "DUMP' OR 'RESTORE': restore 
DUMP/RESTORE MOVED 005 CYLINDERS. 
THERE WERE 000 RECOVERABLE TAPE ERRORS. 


The contents of the user's permanent disk have been replaced 
by the contents of the dump tape. No errors occurred, 


Error Messages: 


None. I/O errors are retried 10 times. If no recovery is made, 
Response (b) is typed. 





“. 
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EDIT 
3.1.6 EDIT 
Purpose: 


EDIT has two purposes: (1) to create card image files 
on the permanent disk and (2) to make changes to 
existing card-image files on the permanent or temporary 


disk. 
Format: 
oy eee ee ne ee 1 
EDIT filename filetype : 
' 
‘ E : : 
. Re eS ees eet Son ee eee ek hot 
filename specifies the filename of the 
| file to be edited or created. - 
filetype specifies the filetype of the 
file to be edited or created. 
Usage: 


If a file with the specified filename and filetype 

does not exist, EDIT assumes the file is being created, 
the Input environment is entered, and information typed 
by the user thereafter becomes input to that file. 

If such a file does exist, the EDIT environment is 
entered, enabling the user to issue EDIT requests and 
to modify the specified file. 


Input Environment: The Input environment is indicated 
by the message “1NPUT", a carriage return, and the 
unlocking of the keyboard. The user may then type 
successive lines of input to the file as fast as he 
eae One card image is created from each input 

ine. rz 


For files that have a filetype of ASP360, COPY, UPDATE 
or SYSIN, each input line is truncated after column 
72. %QIn the Inout environment, if such a line contains 
a non-blank character in column 72, the message 
"STATEMENT CONTINUES:" will be typed. For files that 
have the filetype LISTING, the truncation column is 
column 132. For files that have a filetype of MeMO, 
the truncation column is column 80. For all 80 char- 
-acter files that have-a-filetype other than ASP360, ~ 
SYSIN, COPY, UPDATE or MEMO, each input line is 
truncated after column 72. Files with record length 
other than 80 or 132, will be truncated at the full 
line length. 





Normally, an identifier is placed in columns 73-80 of each card 
image. The identifier consists of a three character identification 


and a five digit sequence number. 


The identification is taken 


from the first three characters of the filename; the sequence 
number begins at 00010 and is incremented by 10. The line 
identifier in columns 73-80 can be changed by issuing the 


SERIAL request in the Edit invironment. 


The placing of the identifier in columns 73-80 can be eliminated 
by specifying no serialization in the SERIAL request; this 
causes the truncation of input lines at column 80 and no other 


identifier assizened to each card image. 


A file whose filetype 


is SCRIPT, LISTING or MEMO automatically defaults to no 


serialization. 


Internal or logical tab settings indicate a column position 

that defines the beginning of a field within a card image. The 
logical tab settings are automatically assumed according to the 
filetype specified. These internal tab settings have no relation 
to the external tab settings on the terminal. The assumed 
internal tab settings are given below, where the first of these 
numbers indicate the column of the card image in which input 


is to begin. 


Filetype Specified 


in EDIT Command 


FORTRAN 
SYSIN 
ASP360 
COPY 
FLOW 
UPDATE 
PLI 


SPLI1 
SNOBOL 


EXEC 
REPS 
TEXT 
default settings 


Assumed Tab Settines 


1, 7%10,15,20;,25;39 
110516, 915.35, 4144665 51450,72 
Same as SYSIN 7 : 
Same as SYSIN 

Same as SYSIN 

Same as SYSIN 

29105 55 2052555043940, 
45,50; 55:00 | 

by 74 b7 5 30240 550,60 

1,10, 20,525, 304.39540;45; 
50,55,60 

LOSS aL sy2e pol 

7 EO ns re AS Sean | Owe Be) 

Same as REPS 

£53.10 51542047 20400 5 204 
40,45,50 


If the specified filetype is not one of those listed, the defauit 
setting of every five spaces is assumed. The assumed tab | 
settings can be redefined by the TABSET request from the Edit 


environment.” ~~ 


There is a character used in conjunction with the logical tab 
settings and it is called the logical tab character. This 
character causes blanks to be inserted into the card image from 
the column position at which this character is input up to the 
first column position of the next field defined by the logical 


3/9/70 
3.1.63 
EDIT 


tab settings. The next character from the input line after 
the logical tab character will be inserted as the first character 
of the next field. The standard logical tab character is the 
exclamation point (! ). The logical tab character can be rede- 
fined by the TABDEF request from the Edit environment to allow 
the character ! to be used as a normal input cnaracter. The 
physical tab key on the terminal can also be used for blank 
insertions, as it is interpreted in the same manner as the 
logical tab character. The only difference between the tab key 
and the logical tab character is that the tab key moves the 
typing element to the next physical tab stop and does not print 
en the tab key is depressed; whereas, the logical tab character 
prints when the character is depressed and the typing element 
does not move to the next physical tab stop. 


There is a character used to backspace one column position in a 
card image and it is called a logical backspace character. For 
“n" logical backspace characters, "n" column positions are back- 
Spaced in the card image and the "n" backspaced positions are 
overlaid with the "n" characters argh follow the "n" logical 
backspace characters. If no character is given after a logical 
backspace character, the previously entered character will not 
be overlaid. The backspacing is performed for the column 
positions of a card mine and not noe ne SHE OeRCES: of an 
imput line.. ead 


The standard logical backspace character is the percent 
character (%). The logical backspace character can be redefined 
by the BACKSPACE request from the Edit environment to allow 

the character % to be used as a normal input character. The 
logical backspace character should not be confused with the 
physical backspace.key.on the terminal. The physical backspace 
key moves the typing element back one position and generates 

& valid input character that takes up’ one column in the card 
image for each time the key is depressed. The character generated 
by the backspace key does not print ae entered on the terminal 
and does not print on the orfiin 1@ printer but it backspaces 

the typing element one position per character wnen the card 


image is printed out at the terminal. Thus, the backspace Kev 


allows underscoring and overprinting at the terminal. The 
logical backspace character prints only when entered and does 
not take up a column in the card image; it.logically backspaces 
one column in the card image. 


The Edit environment is entered from the Input environment by 
typing a null line, i.e., a carriage return with no prior input 
on the line. 


“Edit Envirorment. The Edit environment is indicated by the message 


"EDIT", a carriage return, and the uniocking of the keyboard. 
The user may then type requests to the EDIT command. All changes 
to the file become effective immediately; this allows recursive 
modifications to be made to a file.- 
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The logical tab character and the logical backspace character 
can be used in the following requests in the Edit environment 

to insert blanks and to backspace in the card image respectively: 
BLANK, FIND, INSERT, OVERLAY, AND RETYPE. The logical tab 
character and the logical backspace character can be used as 
normal input characters in the "string" operands of the CHANGE, 
LOCATE, and DELETE requests. 


There are two modes in which to operate in the Edit environment: 
"verify" mode and "brief" mode. Verify mode is the normal mode. 
Verify mode is the normal mode and causes an automatic typeout 

of each line that has been changed or searched for as the result 


of a request. The brief mode does not type out the specified 


lines, and thus the user must issue a ‘PRINT request to get the 
typeout if it is desired. 


The input environment is entered from the Edit environment by 
typing the INPUT request, and a carriage return. , 


Notes: 


a. New files created by the EDIT command are written on the | 
permanent disk with mode Pl. 


“b. Existing files being edited can be read in from either the _ 


permanent disk or the temporary disk. If the FILE or SAVE request 
is issued, the final copy of the file is written out to the same 
disk with the same filemode as it previously existed. 


¢. The final copy of a file being edited or the first copy of 
a newly created file will not be permanently written on disk 
until the FILE or SAVE request is issued. 


.d. Associated with each file is a pointer which refers to a line 


in the file considered to be the current line. The current line 
is defined as the line that is being created or edited in the 
file. When the Edit environment is entered from the Input 
environment, the pointer is positioned to the last input line 
typed by the user. When the Input environment is entered 

from the Edit ee the pointer is positioned at the last 
line edited by the user. When the EDIT command begins in the 


Edit environment, the pointer is positioned before the first 


line in the file. 


-e@. A null line is automatically placed in front of the first 


line of a file being created or edited to permit the insertion 
of lines at the beginning of the file. When EDIT begins in the 


Edit environment -or wnen a TOP request, or-possibly the UP re- 


quest, is issued, the pointer is positioned at this null line. 
A null line is also placed after the last line of the file to 
permit additions at the end. When an end-of-file condition 
occurs, the pointer is positioned at this null line after the 
last line. The two null lines never get written on disk. 
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f. If the end-of-file is reached by an EDIT request, a message 
is typed out that states the request that caused the end-of-file 
to be reached and the pointer is pest esonce after the last line 
of the file. 


ge A file must consist of at least one line to be written 
permanently on disk. A file consisting of only a null line may 
not be saved. 


h. To insert a blank line in a file, tye at least one space 
and hit carriage return. 


i. If a new file is being created, the Input environment is | 
entered first. If no serialization is desired or it is desired ~~ 
to input 80 characters per card image, the Edit environment 

must be entered and a SERIAL (NO) request issued before any 

card images are created. 


j. If a file already exists with no identifiers, the > SERIAL (NO) 
request must be given each time the EDIT command is issued in 
order to maintain the data that exists in columns /3-80 of the file. 


k. Logical tab settings that are redefined by the user for a 
file must be redefined each time the EDIT command is issued if 
the same logical tab ‘settings are desired. 


1. If the logical tab character is sudeeinad, “the: ‘TABDEF Veaueee: 
must be issued each time the EDIT command is issued in order to 
use the same redefined logical tab character. 


m. If the logical backspace character is redefined, the BACKSPACE 
request must be issued each time the EDIT command is issued in 
order to use the same redefined backspace character. 


n. If extensive input and/or chang ees are being made to a file, 
it is a good time-sharing practice “to make few additions and/or 
changes at a time, issue the FILE or SAVE reauest, and then 

continue making additions or chances to the file. Tne process 
should be repeated until all additions and/or changes are made. 


o. EDIT uses an eecemed ues work file during execution which 
has the identifier (2NPUTE i) FILE. This work file is automatically 
allocated on the user's permanent disk with a filemode of Pl if 
the file being edited does not exist. If the file being edited 
does exist, the work files are allocated with the same moces 
as the file being edited. If the work file exists when EDIT is 
entered, the messace!"{INPUTI) FILE PL" EXISTS. ALTER TO SAVE 
LAST FILE EDITED OR ERASE. ' The size of ae work file will be 
When EDIT is terminated with either the FILE or QUIT request, 
the work file is erased, 
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p. If previous EDIT terminated abnormally, the current changes 
or the newly created file may not be completely lost. After CM 
has been initialized, issue a LISTF to verify whether (INPUT1) 
FILE Pl exists. If it does, ALTER its filename and filetype. 
Then issue the EDIT command for that ALTERed file. Issuing 
EDIT before ALTERing the filename and filetype, results in the 
message in o. (above) being typed. EDIT will then terminate 
with an error code. 

q. If the file being edited has eid Peer larger than 

80 characters, each record will be truncated to its line length 
when read. When the FILE-or SAVE request is issued, the full logical 
record will be written on the disk. 


re. All input to the file being edited will be converted Eset 
lower case to upper case unless a filetype of MEMO or SCRIPT. 
has been specified. .A MEMO file or SCRIPT file i the 
characters as is without translation. 


se Ifa filetype of REPS or TEXT is EDITed, tab settings will 
be assumed and a "12-2-9" character will be inserted into column 1 
if it appears blank. | 


t. If a null line is entered in the Input environment, the Edit 
-environment is-entered. If a null line is entered in the Edit 
environment, the contirming message "EDIT" is typed out. To 
enter the Input environment from the Edit environment, issue 

the INPUT (I) request. 


Responses: 


_ NEW FILE 


The specified file does not exist, thus the Input environment 
will be entered. All subsequent input lines will be accepted as 
input to the file. 


INPUT: 
The input environment is entered. The logical tab settings may 
be either those defined by the user or those assumed from the 


filetype. All subsequent input lines will be accepted as input 
to the file. 


DEFAULT TABS SET 


The filetype specified is not recognized by the EDIT command; 





_ thus the default settings are taken for .the logical tab_settings. ..... 


EDIT: 


’ The Edit environment is entered. The logical tab settings may 
be either those defined by the user or those assumed from the 
filetype. Edit request may now be -issued. 
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TRUNCATED 


The input line was too long. If the request "SERIAL (NO)" had 
been previously issued or the filetype was MEMO, the input line 
was truncated after 80 columns; if the filetype was ASP360 or 
SYSIN, it was truncated after column 71; otherwise, it was 
truncated after column 72. Continue typing more input. 


“INVALID EDIT REQUEST: xxx...XXX 


The invalid request xxx...xxx was issued to the Edit environment. 
Check to see if too many arguements were specified with the 
request or if a non-numeric field was specified for a numeric 
argument. Correct the request and issue it again. 


EOF: 


The end of the file has been reached during the EDIT request 
XXXeeeXXX. The request has been terminated and the pointer is 
positioned at the null line after the last line of the file. 
Another EDIT request may be issued. 


STATEMENT CONTINUES: 
A non-blank character has been entered as Input into column 72 
of a SYSIN, ASP360, UPDATE or COPY file. If this was intentional, 
proceed. Oth rerwise, leave the Input environment and correct 
the line. | 


Error Message: 





E(00002) FILE EMPTY - EXIT TAKEN 
The user attempted to save an empty file. The file will not 
be written on the disk and the EDIT command will be terminated. 


Requests: 


Requests are issued to the EDIT command only when the user is in 
the Edit environment. These requests allow the user to manipulate 
and edit files. If requests are issued during the Input envircn- 
ment, they become lines of input to the file. 


Each request is separated from its operand by one or more spaces 
unless otherwise specified. These spaces can be inserted by 

using the space bar, the tab key, or the logical tab character. 

If the tab key or the logical tab character is used and the request 
has "line" as the operand, the “line" will be placed in the card 
image as if the tab key or logical tab character was the first 
character in "Line". 
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f. Uf the end-of-file is reached by an EDIT request, a message is 
typed out that states the request that caused the end-of-file to be 
reached and the pointer is positioned after the last line of the file, 


g. A file must consist of at least one 
on disk, A file consisting of only a null 


ine to be written permanently 
ine may not be saved, 


h. ' To insert a blank line ina file, type a 
carriage return, 


least one space and hit 


i, If a new file is being created, the Input cnYironment is entered 
first, If no serialization is desired or it is des\red to input 80 
characters per card image, the Edit environmenk must be entered 


and a, SERIAL tNO) request issued before any card images are created, 















j. Ifa file already exists with no identifiers, the WRIA, (NO) ree 
quest must be given each time the EDIT command is\¥ssued in order ; 
to maintain the data that exists in columns 73-80 of tie file, ; 


or a file must 
be redefined each time the EPIL command is is«ued if the same logical 


k. Logical tab secttinus that are redefined by the user 


fab settings are desired, 


af If the louical tab character is redefined, the TABDEF\request 


must be issued cach time the EDIT command is issued in oder to use 
the same redefined logical tab character. 


SPACE 


fequest must be issued cach time the EDIT command is issue 


m, If the topical backspace character is redefined, the BAC 
in order 
to use the same redefined logical backspace character. 
bh. oTf extensive input and/or changes are being made to a file, 
good time-sharing practice to make few additions and/or changes 
time, issue the FILE or SAVED request, and then continue making 
ditions or changes to the file. The process should be repeated unt¥l all 


| —_ 
additions and/or chanyes are made, 


o. EDIT uses two intermediate work files during execution which 
have the identifiers INPUT FILE and INPUT] FILE, These work 
files are automatically allocated on the user's permanent disk 
with a filemode of P) if the file being edited does not exist, If 
the file being edited does exist, the work files are allocated with 
the samme modes as the file being edited. If files already exist with 

ithe sarne identifiers as the work files, they are erased. The size - 
of cach work file will be the size of the file being edited plus changes 
and additions, When EDIT is terminated with cither the VILL or i 
QUIT request, the work files are crased. 


Responses: 








p. If the systern goes down during the EDIT command, the 

current changes or the newly created file may not be completely 
lost. After CMS has been initialized, issue a LISTF and note the 
size of the two work files (if both exist). If both work. files do exist, 
ALTER the fitename agd filetype of the larger of the work files, If 
only one work file oda ALTER its filename and filetype. Then 
issue the BDIT commandifor that ALTERed file. Do not issue ENIT 
before ALSERing the filehame and filetype, as EDIT crascs existing 
work files. 


q. EDIT performs input/o\tput with 80 character logical records, 

If the file being edited has ldgical records larger than 80 characters, 
each record will be truncatedto 80 characters when read. When the 
FILE or SAVE request is isstled, 80 chifracter logical records will be 
written on the disk, 











r, All input to the file being edited will be converted from lower case to 
upper case unless a filetype of MEMO has been specified, A MIEMO file 
accepts the characters as is withlput translation. 


5. Ifa filetype of REPS is EDITdd, tab settings will be assumed 
and a "122-9" character will be inserted into column J if if appears 
Dlank, 


t. If a null line is entered in the Input environment, the KNdit en- 
vironment is entered, If a null line 4s entered in the Edit environ. 
ment, the confirming message "EDI'IK" is typed out, To enter the 
Input enviromnent from the Edit envirpnment, issue the INPUT (J) 
request, 


NO PRIMARY NAME SPECIFIED, 
When the EDIT command was issued, only the filetype was specified, 
The Input environment will be entercd and all subscquent input lines 
will be accepted as input to file, The ustr must specify a filename with 
the FILM or SAVE request when he is reddy to save the file, 


Fido DOWS NOT EXIST; WILL BE CREATED, 
The specified file does not exist, thus the Input environment will be 
entered, All subsequent input lines will be accepted as input to the 
file, 


INPUT: 
The input environment is entered, ‘he logical tab settings may be 
either those defined by the user or those assumed from the filetype. 
All subsequent input lines will be accepted as input to the file. 


ts no t 
/ f 
4.1.68 id 4-1-68 / 
3,1.6-7 3.1, 6-8 : 
EDIT EDIT 







The tab settings which are discussed are internal or logical tab 
DEFAULT 1 










BS SET, settings, not the external or physical tab settings on the terminal, 
The filetype specified is not recognized by the EDIT command; thus, 
the default sctlings\are taken for the logical tab scttings. The requests are listed below and are described on the indicated 
pages: 
EDLY: 
The Edit environment tg entered. The logical tab settings may be Request Pape 
either those defined by the user or those assumed from the filetype. 
Edit request may now be issued, BACKSPACE 3. 1. 6-9 
BACKUP 3.1. 6-10 
TRUNCATED. ‘ _ BLANK 3.1. 6-11 
The input line was too long. Wf the request "SERIAL (NO)" had been - BOTTOM 3.1. 6-12 
previously issued or the filetype was MEMO, the input line was ' BRIEF 3.1. 6-13 
truncated after 80 columns; if the filetype was ASP360 or SYSIN, it CHANGE 3.1, 6-14 
was truncated after column 71; Af{nerwise, it was truncated after DELETE" . 3.1, 6-16 
column 72, Continue typing mord input. FILE 3,1. 6-18 
FIND 3.1, 6-20 
INVALID REQUEST: xxx... xx INPUT 3.1. 6-22 
The invalid request xxx... xxx was i¥sued to the Edit environment, INSERT (3.1. 6-23 
Check to see if too many argurnents Were specified with the request LOCATE 3.1,6-25 
or if a non-numeric field was specified for a nurnecric argurnent. NEXT 3.1.6-27 
Correct the request and issue it again. OVERLAY 3.1. 6-28 
PRINT 3.1. 6-30 
EOF REACHED BY: xxx... xxx QUIT 3.1. 6-31 
The end of the file has been reached during the EDIT request xxx... xxx, REPEAT 3.1. 6-32 
The request has been terminated and the pinter is positioned at the null RETYPE 3.1. 6-33 
line after the Jast linc of the file. Another\EDIT requcst may be issued. SAVE ~3.1, 6-34 
SERIAL 3.1. 6-36 
Error Message: TABDEF 3.1, 6-38 
mee eek TABSET 3.1, 6-39 
#(00002) FILE EMPTY - EXIT TAKEN TOP 3,1, 6-41 
The user attempted to save an empty file. \The file will not be UP 3.1. 6-42 : 
written on the disk and the EDIT command Will be terminated, VERIFY 3.1, 6-43 


Requests: 


Requests are issued to the EDIT command only whan the user is in 
the Edit environment, These requests allow the us¢r to manipulate 
and edit files. If requests are issued during the Inptt environment, 
they become lines of input to the file. ~~ 


nic A 


Each request is separated from its operand by one or more spaces 
‘unless otherwise specified. These spaces can be inserted by using 
the space bar, the tab key, or the logical tab character. If the tab 
key or the logical tab character is used and the request has "line! 
as the operand, the "line" will be placed in the card image as if the 

tab key or logical tab character was the first character in "line", 





C 
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3.1.6 EDIT 


1. 


26 


3. 


Additional Notes: 


The truncation columns used for EDIT requests are as follows: 


INPUT and REPLACE - column 72 for SYSIN, ASP360, COPY 
and UPDATE, with continuation punch 
checking 
Column 72 for FORTRAN, PLI, SPLI, 
SNOBOL AED, FLOW, EXEC, MAD, AS1130, 
and REPS files 
column 132 for SCRIPT, and pean 
files 
column 80 for other files 

FIND, OVERLAY, and BLANK - column 80 
LOCATE and CHANGE - end ZONE column 
PRINT - column 72 if serialization is defaulted on or if 
VERIFY column is set after serialization is turned 
on; otherwise ail 80 columns are printed. 
VERIFY - column 72 unless set otherwise 


An asterisk (*) can be used to mean waeOnE 4 or eee in 
~a@ change request--as- follows: .------- 3 is 


C /af/b/** | 


A filetype of MEMO is used to input 80 character card images 
containing both upper and lower case letters. 


The EDIT command allows processing of SCRIPT files in a form 
compatible with the SCRIPT PRINT command LE the filaty me 


ee en - & -~ Wb nde di ul @ Pe a oe on ee So B ii 


is SCRIPT, all input lines introduced under eas and strinzs 
introduced through use of CHANGE, OVERLAY, RETYPE, and INSERT 
are interpreted without converting lower-case characters to 
upper-case. The character-de;ete “and line-delete symbols 
have the usual effect; all other characters are stored without 
modification. . 


For SCRIPT files, the file format is set to "V" (cariable- 
length records) so that the SCRIPT command can be used to edit 
or print files created by the EDIT command. 


Input lines containing a backspace character are converted 
into canonical form such that only one backspace follows 

any character end precedes the character which will overprint 
the character aca the backspace. | 





7. 


| 3/9/70 
3.1.6-8B 
EDIT. 


EDIT recognizes the file type of MEMO, SCRIPT, LISTING, COPY, 
SYSIN, UPDATE, AED, MAD, and AS11130, in addition to those 
mentioned on page 3.1.6-2. 


If no line is specified with the RETYPE request, the current 
line is deleted and the INPUT environment is entered. 


The assumed tab settings are as follows: 


MEMO default settings 
SCRIPT default settings 
LISTING default settings 
COPY same as SYSIN 
UPDATE same as SYSIN 
> AED _ hy 105-15 y- 205. 255 30, 35, 40, 45 
MAD same As AED , 
AS1130 | 21, 27, 32, 35, 45, 50, 55, 60 


In addition to its obvious uses in searching and modifying 
fixed-format card files, the ZONE request has utility in 
source program editing for adding comment fields, setting in 
continuation characters, searching on the serialization 


field, etc. 


Serialization is suppressed for all filetypes except FORTRAN, 
PLI, SYSIN, UPDATE, COPY, SPL1, SNOBOL, AED, FLOW, EXEC, MAD, 
AS1130, and REPS « "Le serialization is tur ned on for other 
filetypes, and either ZONE 1 71 or SERIAL id is not issued 
during subsequent Edits of the file, serialization characters 
may be inadvertantly shifted into column 72 or columns 73-80 
may be overwritten. 
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3.1.6-9 
a, a | EDIT 
O a 3 BACKS PACE 
a | BACKSPACE | | 
Format: 

grrr tee ete one cee re--r eee oe ee ee te ne ee eee et ae a ee ee eg ry 
‘ 4 : 
s Gaeteeae [ character 
‘ BACK it A 
€. g 4 
-£ ' t 


SEBS aASBHeH ETc ewwewraetMeswsaec cae eG eweowo nes wen ecaos 
aa =. : ~ & te 7 


= : = et 


character is any valid character. The default 
‘character is '' %."' 


Usage: 


The BACKSPACE request defines the character to be used as the logical backspace 
character in the Input environment. If the request is not issued, the default 
' character is assumed. The logical backspace character causes one column to be 
_ backspaced in the card image for each logical backspace character in the input 
e line. 


_.The backspace character must be redefined to-allow the % character to be used 
as a normal input character. 





If BACKSPACE is issued without specifying a character, the logical backspace 
character is reset to the % cnareciee: 


The backspace character is very useful for defining continuation cards in FORTRAN 
files. If the first logical tab setting is set to columin 7, the tab key or logical tab 
character followed by a logical backspace character may be used to enter a chara- . 
cter in column 6 instead of counting forward the appropriate number of spaces. a 
example of the use of the logical backspace character follows: 


column 
‘ 4 6 
input line: i345! pase! ) 
card image in file: 5'PAGE! ) 


This places "5'PAGE‘)'' beginning in column 6 of the card image. 


Responses: 


q Examples: 


a. BACK $ 
The character $ will be defined as the logical backspace character. The character 
% may now be used as a normal input character. 


ele epeeSN eeOatt Eh TTT 


ayy 


(0 
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3.1.6 EDIT 


. 


| 
Additional Notes: 
1, The truncation columns used for EDIT requests are as follows: 


INPUT and REPLACE,- column 71 for SYSIN, ASP 360, COPY, 
*y and UPDATE 
“column 72 for FORTRAN, PLI, SPL, 
\ SNOBOL, AED, FLOW, EXEC, MAD, 
“AS 1130, and REPS files 
column 132 for SCRIPT, and LISTING files 
> : coluton &0 for other files: 


\ 

FIND, OVERLAY, and BLANK 4.column 80 
LOCATE and CHANGE - end ZONPAcolumn 
PRINT - column 72 if Eee aa on or if VERIVY 8. 


columin is set after serialization is turked on; otherwise all 80 
columns are printed. 












VERIFY - column 72 unless set otherwise 


2. An asterisk (#) can be used to mean "to BOF" tr "GLOBAL" ina 


change request as follows: 


C falb/ * * 


3. A filetype of MEMO is used to input 80 character car¢ 
containing both upper and lower case letters. 


images 


4, The EDIT command allows processing of SCRIPT files in & form 
compatible with the SCRIPT PRINT command. If the filctyke is 
SCRIPT, all input lines introduced under INPUT and strings 
introduced through use of CHANGE, OVERLAY, RETYPE, ahd 
INSERT are interpreted without converting lower-case charac 
to upper-case, The character-delete and linc-delete syrnbolg } 
the usual effect; all other characters are stored without modifi 


ee | 10, 


For SCRIPT files, the file format is set to "V"' (variable-length 
records) so that the SCRIPT command can be used to edit or print 
files'created by the EDIT’ command. 


5, Input lines containing a backspace character are converted into 
canonical form such that only one backspace follows any character 


71 
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3.1.6 - 8B 
EDIT 





and precedes the character which will overprint the character 
preceding the backspace. 





The logical tab character is defined as the # sign. The i sign is also 
the logical carriafe return character ox line-end character and 
allows for multiple\commands per line of input. The logical line-end 
character takes pre edence over the tab character, therefore, the 
LINIEND command myst be issued to allow the # to be used as the 

tab character. 


EDIV’ recognizes the fildtype of MEMO, SCRIPT, LISTING, COPY, 
SYSIN, UPNATE, AED, \ AD, and AS 1130, in addition to those 
mentioned on page 3.1.6 2. 


If no ne is specified with the RETYPE request, the current line is 
deleted and the INPUT environment is entered, 
The assumed tab settings Bae We follows: 


MEMO default Acttings 
SCRIPT default: settings 


LISTING default s&éttings 

COPY same as SYSIN 

UPDATE saine as SYSIN 

AED 1, 10, 15,420, 25, 30, 35, 40, 45 
MAD same as AIS) 

AS 1130 


21, 27, 32, \35, 45, 50, 55, 60 


In addition to its obvious uses in seArching and modifying fixed- 
format card files, the ZONE request has utility in source program 
editing for adding comment fields, sQtting in continuation characters, 
searching on the serialization field, dtc. 


. 





Serialization is suppressed for all filetypes except FORTRAN, PLI, 
SYSIN, UPDATE, COPY, SPI.1, SNOBDOL, AMD, FLOW, EXEC, 
MAD, AS1130, and REPS, If serialization is turned on for other 
filetypes, and either ZONE 17 1 or SIERIWL id is not issued during 
subscquent Edits of the file, serialization characters may be 
inadvertantly shifted into column 72 or columns 73-80 may be 
overwritten. 
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EDIT 
BACKSPACK 
BACKSPACK 
Format: 

Pe ee ee ee Oe Ue a a Dace pe ey ene ' 

; 

oe t | { character 

' BACK mn 

4 t ! 

' i] s 


character is any vad character. The default 
character tg '' %."" 
: *, 


Usage: 
- \ . 
The BACKSPACI request defines the character to be used as the logical backspace 
‘, ‘ : 

character in the Input environment. If the request is not issued, the default 
charactey is assumed. The logic] backspace character causes one column to be 
backspaced in the card image for @ach logical backspace character in the input 
linc. 












The backspace character must be redefined to allow the % character to be used 
as a normal input character. 


If BACKSPACT is issued without specifyin 
character is reset to the % character. 


a character, the logical backspace 


The backspace character is very useful for dXining continuation cards in FORTRAN 
files. If the first logical tab setting is sct to cNunin 7, the tab key or logical tab 
character followed by a logical backspace charaXer may be used to enter a chara- 
cter in column 6 instead of counting forward the appropriate number of spaces. An 
example of the use of the logical backspace charact:r follows: 


column 
4 6 
input line: 
card image in file: 
This places ''5'PAGE')" beginning in column 6 of the card image. 
Responses: 
The keyboaad is unlocked. 
: 


a. BACK $ 
The character $ will be defined as the logical backspace character. The character 
% may now be used as a normal input character. 





‘ 
boa 
aed 


4.1-68 
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BACKUP 
BACKUP 
Format; 

COR Ors Po eg DUST a Soaps eyes ee ne mn, pg 

‘ ' - -. 1 

' BACKUP ' n : 

’ UP ‘ l ' 

' U ' ae ' 

! 1 | ‘ 

Cue cecccneeeeeee’ Jno aie aie ai Sooo 

n : . is an integer indicating the number of 


lines by which the pointer should be moved 
back, The default is 1 line. 


U sage: 


The BACKUP request repositions the pointer ''n" lines before 
the current line. If "nis 0 or unspecified, a value of 1 is 
assumed and the pointer is moved up to the previous line in the 
file. If "mn" is greater than the number of lines between the top 
of the file and the current line, the request will function as a 
TOP request. 


Responses: 


Verify mode; The line at which the pointer is repositioned is 
printed and the keyboard is unlocked, 


Brief mode: ‘The keyboard is unlocked. 


Example S: 
a U 9 


This request repositions the pointer 9 lines before the current line, 
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EDIT 
BLANK 
BLANK 

Format 

ral area paceai: aay 

§ 1 i] 

t BLANK | ; { 

¢ ' I 

Poowesetere tess asesiesceaen J 

line is any valid input line 

Usage: 


The BLANK request places blanks in the current line wherever non- 
blank characters occur in "line", 


The tab key and the logical tab character can be used to generate 
__ blanks in the card image. 


The "line" is separated from the request by only one blank. All 
other blanks are considered part of "line". 


Re sponses: 


Verify Mode: The changed line is printed out. The keyboard is unlocked. 


Brief Mode: The keyboard is unlocked. 
EOF ¢s 


The end of file was reached by the request, For BLANK 
to reach the end of file, a REPEAT request had to be issued prior to 
the BLANK. 


e 
Example: 


a. BLANK AAAAAA A 


column 





: 1 : __$ 8 
line before request: ABCDFJMNOP 
request: blank aaaaaa a 
line after request: M OP 


Blanks are placed in columns 1-6 and 8 of the current line in the file. 


4.1-68 


3.1, 6-11 VA 


BLANK 


Format: 
— 






er 


PS eee 1 
t ! j 
1 BLANK | ; | 
! B ’ line , 
1 § ' 
Vedeoucascsteese Stembeatcees J 
\ 
line is any valid input line 


Usage: 









The BLANK request places blank’g in the current line wherever non- 


blank characters occur in ''line", 
| 
The tab key and the logical tab char\cter can be used to generate 


blanks in the card image. 


The "line" is separated from the reque¥t by only one blank, All 


other blanks are considered part of "link". 


Responses: 
Verify Mode: The changed line is printed dat. The keyboard is unlocked. 
Brief Mode; The keyboard is unlocked. 


EOF REACHED BY: xxx... XXX 


The end of file was reached by the request xxx... xxx, For BLANK 
to reach the end of file, a REPEAT request had\to be issued prior to 
the BLANK. 


Example: 
Foil be Vaal 


a. BLANK AAAAAA A 


column 
1 6 8 





ABCDFJMNOP 
blank aaaaaa a 


M OP 


line before request: 
reque st: 
line after request: 


‘Blani:s are placed in colurnns 1-6 and 8 of the current line in the file. 





“fe 
6 
41-68 
3.1, 6-12 
EDIT 
BOTTOM 


BOTTOM 
Format: 
PRR nn a ‘71 
| (BOTTOM { 
j BO ! 
Locvawecas eee a 
Usage: 2 


BOTTOM positions the pointer at the null line after the last line of the file. 


Example: 
a. BO 


The pointer is positioned at the bottom of the file, 


76 


4-1- 
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EDIT / 

BRIEF 


BRIEF 
Format: 
Pt ce ee ’ 
) (BRIEF) 4 
! BR y 
Cocstcscees J 
Usage 


The BRIEF request turns off the verify mode (sec the VERIFY - 
request) and turns on the brief mode in the Edit environment. 

In the brief mode lines that are changed in the file will not be 

typed out automatically, The requests that are affected by BRIEF 
are BACKUP, BLANK, CHANGE, FIND, LOCATE, and OVERLAY. 


Example: 


a BR 
This request turns on the brief mode. 


7 4-1-68 (7 
ig / : 3.1. 6414 
EDIT. 
CHANGE 
CHANGE 
Format: 7 
Pye ee aS Bs Se Sp wee Te a ye gh Ogi ge 1 





i a 

i CHANGE 7 

I Cc 1 
L 


/ is any unique delimiting character that does 
not appear in stringl or string2. 


string] -is the group of characters to be replaced. 







string2 is the group of characters that replace stringl. 
n specifies the pumber of lines to be searched 
for stringl. The default is 1 line. 
‘ 
GG signifies that the: change is to be applied to 
every occurrence\of string] in the lines. 
“ ; signifies that all lings from the current line 


to the end-of-file are\to be scarched. 
Usage: 


The CHANGE request replaces the occurrencd of string] in ''n" 

lincs by string 2. If Gis specified, every occ\rrence of string! 

in "n'' or "*" lines is changed; if Gis not speciNed, only the first 
occurrence of stringl is chanped, If neither 'n'\nor "*"" is specified, 
only the current line will be searched for string 1 


Jf the occurrence of string] is not found, the linc(shis not altered. 
The pointer remains positioned at the last line searched for the 
occurrence of string]. 


Stringl and string2 can be of different lengths. Each of the "n'! 
or "=" lines will be expanded or compressed accordingly. 


If an end of file condition immediately preceded the CHANGE, an 
automatic TOP request is performed before CHANGE begins. 
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3.1.6-14 
EDIT 
CHANGE 
CHANGE 
Format: 
Ge eee ee ake ' 
; : n GLOBAL : 
t ‘ ‘ 
i A ‘ * G ‘ 
; rae : “/stringl/string2/ l es : 
r i a 
Lebnoneeeewe Cenacle eb baeasaswesaeoeceee aos ' 
/ _is any unique delimiting character that does. 
not appear in stringl or string2. 
' stringl is the group of characters to be replaced. 
string2 is the group of characters that replace 
stringl. | 
n 7 specifies the number of lines to be searched 
for stringl. The default is 1 line. 
M-Or.%....... -signifies.-that.-...n-or.all..lines..from.the current 
: | line to the end-of-file are to searched. 
GLOBAL or G signifies that the change is to be applied 
or to every occurrence of stringl in the lines. 
Usage: 


The CHANGE request replaces the occurrence of stringl in "n" 
lines by string 2. If G is specified, every occurrence of 
String! an "ni" or "Ss" lines ts chaneedy if G is not specified, 
only the first occurrence of stringil is changed. If neither 

nn" nor "*" is specified, only the current line will be searched 
for string l. 


If the occurrence of stringl is not found, the line(s) is not 
altered. The pointer remains positioned at the last line 
searched for the occurrence of stringl. 


Stringl and string2 can be of different lengths. Each of the. "n" 
or "*«" lines will be expanded or compressed accordingly. 


If an end of file condition immediately preceded the CHANGE, an _ 


automatic TOP request is performed before CHANGE begins. 





¥ 
te 


: : 3/9/70 
| | 3.1. 6-15 
4 3 Ss efi : EDIT 
| | CHANGE 


Notes: 
a. The "n'' or '*" ig required if G is to be specified. 


b. If nis greater than the number of lines to the end of the file, 
every occurrence of string | from the current line to the end will 
be changed. The logical backspace character and the logical tab 
character cannot be used in stringl or string2, as they will be con- 
; ' sidered normal input characters in either string. 





c. Ina SYSIN or ASP360 file, only 71 characters of an 80 character. 
- Tine can be changed. Thatis, only the first 71 characters are scanned 
“for stringl, Ina MEMO file or one that has requested no serialization, 
all 80 characters canbe changed. In all other filetypes, only 72 
characters can be changed. | 


Responses: 


Verify Mode: The changed line(s) is printed out and the keyboard is 
et dS AS eee ae ee eee ee eT eee ae 
Brief Mode: The keyboard is unlocked. 


_ EOF? fa . 
The end of file was reached by the request xxx...xxx. To position 
the pointer at the top of the file, a TOP request must be issued. 
When a FIND LOCATE, or CHANGE request is issued after the 
occurrence of an end of file condition, a TOP request is automatically 
issued before the request begins. 


a ee ee eee 


Examples: | 
ae GC /ALPHA/DELTA/ ! Column 
4 7410 145 
line before request: ALPHAS ALPHA © DETA 
request: c /alpna/ielta/ 
line after request: DELTAS ALPHA = SETA 


The first occurrence of ALPHA in the one line is changed to DELTA. 





b. C *ALPHA*DELTA* 1 G | Column 
7 | | 4 74 45 
line before request: ALPHA= ALPHA - GETA 


C request: ¢ *alphatceltat Lz 
| line after request: NELTA=VDELTA = GETA 


| 2D Every occurrence of ALPHA in the one line is changed to DELTA. 








TARE 





ws 
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ry 
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3.1, 6-16 
EDIT 
DELETE C 
DELETE | 
Format: 
een earn be ee eS ee | 
§ i n ' 
— 
Spa i as { ; 1 
ey Gere 0 ne _—. | 
{ i /string/ 
| RERUN or eee ean Jose eosteee ue ee J 
n specifies the number of lines to be 
deleted. The default is 1 line. 
{ . is any unique delimiting character that 
_.. does not appear in the string. 
string specifies the character string to be 
located before deleting lines from | 
the current line to the line containing 
“string.” 
Usage: : . a | 7 | 
If ''n" is specified, the DELETE request removes 'n!'' lines from C 


Response: 


the file starting with the line at which the pointer is currently 
positioned. Upon completion of this request, the pointer is positioned 
after the last deleted line. If'"n'" is 0, only the current line is deleted. 


If /string/ is specified, DELETE first issues a''LOCATE /string/" 
command. [ff 'string'' exists, all lines from the current line to, but 
not including, the line containing ''string'! are deleted. The pointer 
will be positioned at the line containing "string." 


If "string" is not located, no lines will be deleted, the end-of-file 
message is typed out, and the pointer is positioned after the last 


line. 


If neither ''n' nor ''string" is specified, only the current line is 
deleted. 


The keyboard is unlocked. 


EOF: i ae > 
The end of file was reached by the request, fo position : C 
the pointer at the top of the file, a TOP request must be issued, : 


4~1.~68 
3.1, 6-15 4s 
EDIT ae 
CHANGE 


"Notes: 
a. The ''n' or '* is required if Gis to be specified, 


b. If nis greater than the pumber of lines to the end of the file, 
every occurrence of string l\from the current line to the end will 
bé changed, The logical backspace character and the logical tab 
character cannot be used in stXingl or string2, as they will be con- 
sidered normal input characterA&in cither string. 










c. Ina SYSIN or ASP360 file, onhy 71 characters of an 80 character 
line can be changed. That is, only She first 71 characters are scanned 
‘for stringl. In a MEMO file or one that has requested no serialization, 
ali 80 characters can be changed. In Aj1 other filetypes, only 72 


characters can be changed. 
Responses: 
The changed line(s) is printed 


unlocked, 
The keyboard is unlocked. 


Verify Mode: ut and the keyboard is 


Brief Mode: 


EOF REACHED BY: xxx... xxx 
The end of file was reached by the request xxx...2%&x, To position 
the pointer at the top of the file, a TOP request mist be issued, 
When a FIND LOCATE, or CHANG request is issudd after the 
occurrence of an end of file condition, a TOP request\is automatically 
issucd before the re quest begins, 


Examples: 


a. C /ALPHA/DELTA/ Column 


4 7:40 #15 


ALPHA= ALPHA 


c f/alpha/Jdolta/ 
DELTAS ALPHA = 


linc before request: 
request: 
line after request: 


The first occurrence of ALPHA in the one line is changed to DELTA, 
Column 
sen en 
ALPHA® ALPUA = DETA 


c *talphatceltas 1 zg 
DELTASDELTA - GETA 


b. C *ALPHASDELTA* 4 G 


line before request: 
request: 
linc after request: 


Every occurrence of ALPIIA in the one line is changed to DELTA, 
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3,1, 6-16 
EDIT 
DELETE 
DELETE 
Format; 
string specifies the character string to be 
located befgre deleting lines from 
the current line to the line containing 
string," 
Usage: ; 


If "n" is specified, the DM LETE rashes removes "n" lines from 
the file starting with the line at which\the pointer is currently 
positioned, Upon compliction of this réquest, the pointer is positioned 


after the last deleted line. If''n' is 0,\ only the current Hine is deleted, 


\ 
If /etring/ is specified, DELETE first igsues a "LOCATE /string/" 
command, If ' string" exists, all lines from the current line to, but 
not including, the line containing "string"\are deleted, The pointer 
will be positioned at the line containing "string. "! 


If string" is not located, no lines will be deleted, the end-of-file 
message is typed out, and the pointer is positioned after the last 
line, \ 

: : y 
If neither "n" nor "string" is specified, only the current line is 
deleted. 


Response: 
The keyboard is unlocked. 
EOF REACHED BY: xxx... xxx 


The end of file was reached by the request xxx...xxx. To position 
the pointer at the top of the file, a TOP request must be issued, 
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4-1-68 
.6-17 
EOE 
DELETE 


Example 8: 


a D 5 
This request deletes the current line plus.the next four lines, 


b. D /SUBROUTINE WRITEX/ 
This request scans for "SUBROUTINE WRITEX" from the current 
line to end-of-file, Once the string is located, all lines from the 


current line to the line containing "SUBROUTINIE] WRITEX" are 
deleted, 


If the string is not located, no lines are deleted, 





i 


Responses: ees 
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4 


ot 3.1. 6-18 
EDIT 


“FILE 


Format: 







won ewe ne 
_ 
A 
_— 
oe 
5 
aad 


t 
[filenme] 
1 
' 


ee Ce 


filename specifies the Wame to be used as the 


filename. 


Usage: \ 
The FILE request terminates the editing oth file. A permanent copy of the file is 
written on the disk a8 it existed after the 1 = pass threagh the file. If the file is 
being permanently stercd for the first time, if is written on the permanent disk 
with mode PL, Lf the file already exists on theidisk, it is written on the same disk 
in the same mode as it previously existed. ‘Thhs latest copy replaces any existing 
copy of the file on the disk and the file disector)\is updated. 







tts 


If "filename" is specified, it is used as the filené 
not specified, the filename used at the time of the 
isused. If "filename" is not specified at cither ti 


me of the file. If "filename" is 
invocation of the EDIT command ° 
ec, a message is typed out. 


After the file has been written on disk, control is returned to the CMS environment. 


The EDIT command is terminated and an entry for the {ile is entered in the appropri- 
ate file directory. 





FILE EMPTY - EXIT TAKEN 
The FILE request was issued for au empty file. 
and its entry will he removed from the file directory. 
generated and the EDIT command terminated. 


No file w{l be saved on the disk 
The\crror E(00002) will be 


NO PRIMARY NAME SPECIVIED - RETRY \ 


A filename was not specificd for this file, so it cannot be stored Re-issuc the 
FILE xequest and give the’ filename. 


[xamples: 


a. FILE 
file : 


request: 
R; T=u.85 


response from CMS: 


This request will write the latest copy of the file on disk. 











S/YS IU 


; xt , 3,1.6-18 
: ° ; —— EDIT 
c. 2 ae a a 
Format: = = 
t ee eee Ie ee ee ee | | 
t ee ee eae oe ees io . 
i FILE : — [filename] : 
pieeiiase Apes Nag Clea ous atu oe 
filename... specifies the name to be used as the 
-- ior: ,. filename. wie < 
Usage: a: ial 


The FILE request terminates the editing of a file. A permanent copy of the file is 
written on the disk as it existed after the last pass through the file. [If the file is 
being permanently stored for the first time, it is written on the permanent disk 
with mode Pl, If the file already exists on the disk, it is written on the same disk 
in the same mode as it previously existed. This latest copy replaces any existing 
copy of the file on the disk and the file directory is updated. 





~... If "filename" is specified, it is used as the filename of the file. If "filename" is 
€ not specified, the filename used at the time of the invocation of the EDIT-command* = 
“-  isused. If ''filename" is not specified at either time, a message is typed out. 


After the file has been written on disk, control is returned to the CMS environment. 





Responses: | 
The EDIT command is terminated and an entry for the file is entered in the appropri- 
ate file directory. 
FILE EMPTY - EXIT TAKEN 
The FILE request was issued for an empty file. No file will be saved on the disk 
and its entry will be removed from the file directory. The error E(Q0002) will be 
generated and the EDIT command terminated. 
Examples: 


tr 4 as a Teas Sd 


t 


This request will write the latest copy of the file on disk. 








3/9/70 
3.1.6-19 
EDIT 
FILE 
Examples: (Cont. ) 


b. FILE RECALC 


This request will write the latest copy of the file on disk and RECALC will be 
its filename. | 


ne Ree MAE ot a 
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3.1. 6-20 
EDIT 
FIND 
FIND 
Format 
“fFIND) | 3 
§ i : f 
, { Fr } ' line , 
Beso atc Pe coe e he sessed ’ 
line ’ dg any valid input line. It may contain 
: . blanks and the logical tab character and/or 
stab key. 
; Usag e: 


The FIND request compares the non-blank characters in "line" 
with each line in the file. The compare begins on the next line 
from where the pointer is currently positioned and continues down 


the file until a match occurs or until the end of file is reached. If >>> 


anend of file condition immediately preceded the FIND request, an - 
autornatic TOP request is performed before FIND begins. [If "line" 
is found, the pointer is positioned to the card in which ''line" is 
contained. If "'line'' is not found, the pointer is positioned after 

the last line of the file. The compare is column dependent, as the 
only columns compared in each card image are the ones specified by 
non-blank characters inline’. For example, if "line’ contains 
"AC", the search will be for an Ain column 1 and aC in column 3. 


The ''line' is separated from the request by only one blank. All 
other blanks are considered part of "line", 


FIND can be used to search for a specific line identifier in columns 
73-80, One technique is to issue FIND followed by the appropriate 
number of tabs to position the specified identifier to column 73. 


Responses: 


Verify Mode: The keyboard is unlocked. 
Brief Mode: The keyboard is unlocked 
EOFS : 
The end of file was reached by the request xxx...xxx. To position 
the pointer at the top of the file, a TOP request must! issued. 


When a FIND, LOCATE, or CHANGE request is issuea after the 
occurrence of an end of file condition, a TOP request is automatically 
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3.1. 6-21 
_ EDIT 
FIND 
Examples: | 
a. FIND 90 _ Sonics 
. I 7 
— f 90 : 
Ir est: 


The FIND request searches for 90" in columns 1 and 2. The first line found 
is typed out in the verify mode. 


b. FIND i # SUMX 


Column 
11016 
request: f Ylsumx 


line found: LOOP A SUMX, X 


Assuming that the logical tab settings are setin 1, 10, 16, the request searches 
for “‘SUMX" in columns 16-19. The first line foundis typed outinthe verify | 
ek I a 












; , 4.-1-68 
41-68 fot 5,1, 6-20 
3.1.6-19 : ; EDIT. 
EDIT. FIND 
VILE 
Examples: (Cont. ) FIND 
b. FILE RECALC Format: - 
. request: Peeree ye i re Ae Nig a te cos cae bie ta ds 
response from CMS: kg T#0.63 FIND c q 
: ; ; : line 
This request will write the latest copy of the file on disk and RECALC will be { . } 
its filename. Leese eet Sale Ae ove cee J 
line is any valid input line, It may contain 
blanks and the logical tab character and/or 
le tab kay. 


The FIND request compares the non-blank characters in "line" 
with each line in the file, TVhe\gompare begins on the next line 
from where the pointer is curreptly positioned and continues down 
the file until a match occurs or wWotil the end of file is reached. If 
an end of file condition immediately preceded the FIND request, an - 
automatic TOP request is performed before FIND begins, If "line! 
is found, the pointer is positioned t& the card in which "line" is 
contained, If "line" is not found, th& pointer is positioned after 
the last line of the file. Vhe compardis column dependent, as the 
only columns compared in cach-card ithage are the ones specified by 
non-blank characters in"line!'. For cXample, if "line" contains 
"A C", the search will be for an A inc usin L and a © in column 3, 


The "line" is separated from the request by only one blank, Al) 
other blanks are considered part of "line',\ 


FIND can be used to search for a specific like identifier in columns 
73-80, One technique is to issue FIND followed by the appropriate 
number of tabs to position the specified identifier to column 73, 


Responses: 


Verify Moder The keyboard is unlocke®, \ 
Brief Mode: The keyboard is unlocked \ 


EOF REACHED BY: xxx... xxx 
_ The end of file was reached by the request xxx... xxx. To position 
the pointer at the top of the file, a TOP request must be issued, 
When a FIND, LOCATIZ, or CHANGE request is issued after the 
occurrence of an end of file condition, a TOP request is autornatically 
issued before the request begins. 
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" 4.1.68 A 3.1, 6-22 
3.1,6-21 EDIT 
EDIT, INPUT 
FIND 
Examples: INPUT 
a. FIND 90 aaa Formal: 

ers f 90 ; Cees 
request: : . 1 (INPUS ' 
line found: 20 FORMAT (516) : I , 
Locos oekoe J 


The FIND request searches for 90" in colunins (and 2, The first line found 
is typed out in the verify mode. Usage: 
b. FIND # # SUMX This request causes the Input environment to be entered from 
an ‘ Column the Fdit environment, All subsequent input lincs--including 
: ee Edit request-- are treated as input to the file and are placed 


request: ¢ ##sumx 
line found: LOOP 





after the line at which the pointcr is currently positioned. If 
SUX, X the INPUT request is given at the top of the file, the lines 
ta . ’ . 
appear before the first line of the file, 
Assuming that the logical tab settings are set in 4, 10, 16, the\request searches 
for "'SUMX" in columns 16-19. The first line found is typed out in the verify 
mode. 


If no lines were entered while in the Input environment and 
return is magle to the Edit environment, the pointer is positioned 
‘to the last line of input or to the line pointed to before the Input 
environment was entered. ‘The line after the pointer is the same 
line before and after the Input environment was centered, 


Responses: 
INPUT: 
The Input environment is entered. 
ES Liaise 


a. I 


request: i 
response: INPUT: 


INPU'L enters the Input environment and allows the user to create 
more lines of input to his file. 





\e 
4-01-68 db 
3.1, 6-23 
EDIT. 
INSERT 
INSERT 
Format: 
po ae ge Pe Ne ay a a a it aad ‘ 
{INSERT 
} { 1 \ ' Vine t 
! \ J ' H 
a Te eS aA ae eS eRe ‘ 
linc is the exact input linc: to be inserted into 
; the file. It can obtain blanks and tabs 
(logical tal) character and/or tab key), 
Usage: 


This request inserts the "line" into the file without entering the Input environment. 
The line is inserted following the linc at which the pointer is currently positioned and 
the pointer is advanced to point to thig inserted line. The line is separated from the 
request by only one blank; all other blauks are considered part of "line". 
The conyentions of the Input environment hold true during the INSERT request. 
A blank line can be inserted in the file by using one or more spaces for "line. 
If “line! is omittcd from the INSERT request, it is interpreted as the INPUT 
requcst:and the Input cnvironment-is enterad,. 

Responses: 


The keyboard is unlocked, 


Examples: 
a. IbABLEbbbbbSbhbbbSUM, X 
Column 
a ve Beha t tn AD Ae 2 20 18 
| request: i able _s SUN, X 
: line after request! ABLE . SUH, x 


The input linc "ABLEbbbbbSbbbbbSUM, X"' is inserted in the file. The letter "b" 
is used here to indicate a single space. 


b. HiDO 10 I=4, 25 


Cohunn 
(nee 
request: : i #do 10 41,25 
. line after request: DO 10 '=1,25 








4-1-68 We 
3,1. 6-24 : 
EDIT 
INSERT 


Assuming that the logical tab settings are in 4, 7, 10, and 145, this request inserts 
the FORTRAN statement ‘DO 10 I=4, 25"' in columns 7-48. 


c. INSERT 


request: Insert 
response: INPUT: 


The Input epvironment is entered, as "line' was not specified with the INSERT 


request. 
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4-1-68 
3,1.6-25 . 3.1, 6-26 
EDIr oe EDIT — 

LOCATE : LOCATE 


LOCATE 
Examples: 


Format: 
= a. L /FORMAT/ 





a USES A Siete oss ese eees Column 
' pee } ene er 


/string/ 
; request: 1 /format/ 
Someehieneene we J line located: - 65 FORMAT C'DAELY AUDIT") 


woe 


/ is any\unique delimiting character that 
is not contained in the string. 





string is any group of characters to be searched 
for in the curd images. 


Usage: 


LOCATE scans all 80 characters each ecard image for the 
character string specified between the two delimiters, The 
scan begins on the next line from whith the pointer is currently  - LOCATE searches for ''FORMAT" in columns 1-80 of each line. In the verify 
positioned and continucs until the string is found or until the end mode the first line found is typed out. 

of file is reached, If an end of file condition immediately pre- . 

ceded the LOCATE, an automatic TOP equest is performed be- b. L $61$ 

fore LOCATE begins. If the "string" ishlocated, the pointer is Column 

positioned at the line that contains it, "string" is not located, Be Os 

the pointer is positioned after the last ling of the file, _ request: 1 $61% 

line located: 12316XXX61987654321 








The request is not column dependent, as al 80 characters are 

scanned, The logical tab character and tht tab key cannot be LOCATE searches for ''64"' in columns 1-80 of each linc. In the verify mode 
used to generate blanks in the string. The\logical tab character the first line found is typed out. , 

and the logical backspace character can be \ised as a normal in- 

put character in "string", 


LOCATE can be used to scan for a line identificr if columns 73-80. _ ’ 


Responses: 
Verify Mode: The located line is typed out and the\keyboard is unlocked. 
Brief Mode: The keyboard is unlocked. 


EOF REACHED BY: xxx...Xxx 
The end of file was reached by the request xxx...xxx. To position the pointer 
at the top of the file, a TOP request must he issued. When a FIND or LOCATI: 
request is issued after the occurrence of an end of file condition, a TOP request 
is automatically issucd before the request begins. . ee 
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3.1. 6-25 


EDIT 
LOCATE 
LOCATE 
Format: 
ea Oe or cree eT NRE ee eee | 
a gute string/ | 
: a / g. 
be Sean ees eee ee eels sitet) 
/ is any unique delimiting character that 
is not contained in the string. 
string — is any group of characters to be searched 
for in the card images. 
Usage: 





LOCATE scans all 80 characters in each card image for the 
character string specified between the two delimiters. The 
¢€ scan begins on the next line from which the pointer is currently 
| ) positioned and continues until the string is found or until the end 
of file is reached. If an end of file condition immediately vre- 
ceded the LOCATE, an automatic TOP request is performed be- 
fore LOCATE begins. if the 'string'! is located, the pointer is 
positioned at the line that contains it. If 'string' is not located, 
the pointer is positioned after the last line of the file. 





AM ange ORE My NE ER TR IG AR TEER A Ss OH a, 


The request is not column dependent, as all 80 characters are 
scanned, The logical tab character and the tab key cannot be 
used to generate blanks in the string. The logical tad character 
and the logical backspace character can be used as a normal in- 
put character in ''string'. 


LOCATE can be used to scan for a jine identifier in columns 73-80. 


Responses: 


Verify Mode: The located line is typed out and the keyboard is unlocked. 
_ Brief Mode:_ The keyboard is unlocked. __ 


EOF? kh 
: The end of file was reached by the request xxx...xxx. To position the pointer 
q at the top of the file, a TOP request must be issued.. When a PIND-or LOCATE 
3) request is issued after the occurrence of an end of file condition, a TOP request 


is automatically issued before the request begins. 
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3, 1.6-27 
EDIT 
NEXT 
NEXT 
Format: 
op es ge vp ey oe eae | 
t ’ § 
' NEXT n 
N i} 
s 8 i 
De ee ie Gk Wolke Saale wees eS we wesd t 
n _ ds aninteger indicating the number of lines 
by which the pointer should be advanced. The 
ag default is 4 line. 
Usage: — 


eg 
nN 


_ This request advances the pointer in the file by lines. If “n‘' is O or un- 
specified, a value of 4is assumed and the pointer is advanced to the next line in 
the file. If the end of file is reached before the pointer is advanced ''n" lines, 
the pointer is positioned after the.last line. Specifying a value of ''n'" that 
is greater than the number of lines to the end of file is one method of 
reaching the bottom of the file. | 


Responses: 


The keyboard is unlocked. 


EOF: - ep epee 


The end of file was reached by the request xxx...xxx. To position the pointer 
at the top of the file, a TOP request must be issued. 

Examples: 
a NSO 


This request advances the pointer 5 lines. 
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3.1.6-25 





EDIT 
LOCATE 
LOCATE | : | y | 
Format: 
So oo areal: oe Ee a | 
g {LOCATE } : : { 
: . /string/ , 
ben seeg sess esc eee ene wise J 
f | is any unique delimiting character that 
is not contained in the string. 
string — is any group of characters to be searched 
for in the card images. 
Usage: 


LOCATE scans all 80 characters in each card image for the 
character string specified between the two delimiters. The 
scan begins on the next line from which the pointer is currently 

| positioned and continues until the string is found or until the end 
of file is reached. If an end of file condition immediately vre- 
ceded the LOCATE, an automatic TOP request is performed be- 
fore LOCATE begins. if the "string'' is located, the pointer is 
positioned at the line that contains it. If ''string'' is not located, 
the pointer is positioned after the last line of the file. 


The request is not column dependent, as all 80 characters are 
scanned. The logical tab character and the tab key cannot be 
used to generate blanks in the string, The logical tap character 
and the logical backspace character can be used as a normal in- 





put character in ''string", 


LOCATE can be used to scan for a line identifier in columns 73-80. 


Responses: 


Verify Mode: | The located line is typed out and the keyboard is unlocked. 
Brief Mode: | The keyboard is unlocked. 


EOF? a 

The end of file was reached by the request xxx...xxx. To position the pointer 
C at the top of the file, a TCP request must be issued. When a FIND or LCCATE 
) request is issued after the occurrence of an end of file condition, a TOP request 


is automatically issued before the request begins. 
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3,1.6-27 
EDIT | 
NEXT | 
NEXT a 
Format: 
2 ee ee ee eg ey ee ee eS 
t t ‘ 
' NEXT 
: N ‘ | ( 
“HY 
© cee wee Saco Sees ok cheese ee oeue f] 
2 n _ ds aninteger indicating the number of lines 
by which the pointer should be advanced. The 
default is 1 line. 
Usage: . 


west 


_ This request advances the pointer in the file by ''n"* lines. If "n"’ is 0 or un- 
specified, a value of fis assumed and the pointer is advanced to the next line in 
the file. If the end of file is reached before the pointer is advanced ‘'n" lines, 
the pointer is positioned after the.last line. Specifying a value of ''n" that 
is greater than the number of lines to the end of file is one method of 
reaching the bottom of the file. 


Responses: 
The keyboard is unlocked. 


EOFs’ - es we 
The end of file was reached by the request xxx...xxx. To position the pointer 


at the top of the file, a TOP request must be issued. 


Examples: 


a NS 
This request advances the pointer 5 lines. 




















3.1.6-28..._ -3/9/70 
EDIT = _ 
OVERLAY - | 
iis OVERLAY=—_——- Aiea ES he te ee - z 7 ee 
Format: __~— 
} | peewenn ee peouctecsee oe seeewencee ose 
| ae as 
' ie ERLAY | as 
: Q ! _t 
8 : 
8 t { 
.osaaeesee eee Ross 
line is an input line that overlays the © ~*~ ae a a" 
current line. my iye ees ae recor awe we See or 
Usage: 
This r@jueést takes the non-blank characters from "line" and places them in” 
the corresponding position-of the current line. Blank characters in “‘line’'dos- 7° 0 * 


not replace corresponding positions in the current line. If there is more than’ - 
one space efter the request, these spaces will be considered as partof "line. ~ 
The logical tab char racter, the tab key, andt th he Jogi ical backspace character can 
be used in specifying ' line" d . ie coe ee a ae 





Cc _ Responses: 
Verify Mode: ~ ~ The changed line is typed out and the keyboard is uuloeseS: 
Brief Mode: . The keyboard is unlocked. 





EOF) a 
The end of file was reached by the request xxx... xxx. For OVERLAY 
to reach the end of file, the REPEAT request had to be issued prior to" 
the OVERLAY. 


Examples: S 
a. ObbbbbbbbbING Column 
; ] 9 
line before request: easter WER ; 
request: . ins, 


line after request: PROGRA! WING 


Columns 9-11 in the current line are replaced by the non-blank characters in “‘line™’. 
The letter "'b'' is used here to indicate a single space. C 
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3.1. 6-25 
EDIT 
LOCATE 
LOCATE 
Format: 
7 Rone sl ea eas as 4 
g {LOCATE } : { 
: L , /string/ 
Gorse ese eee ee wseucsd 
| is any unique delimiting character that 
is not contained in the string. 
string is any group of characters to be searched 
for in the card images, 
Usage: 


EOCATE scans all 80 characters in each card image for the 
character string specified between the two delimiters. The 
scan begins on the next line from which the pointer is currently 

positioned and continues until the string is found or until the end 
of file is reached. If an end of file condition immediately vre- 
ceded the LOCATE, an automatic TOP request is performed be- 
fore LOCATE begins. if the 'string'! is located, the pointer is 
positioned at the line that contains it. If "string'' is not located, 
the pointer is positioned after the last line of the file. 


The request is not column dependent, as all 80 characters are 
scanned. The logical tab character and the tab key cannot be 
used to generate blanks inthe string. The logical tap character 
and the logical backspace character can be used as a normal in- 
put character in ''string". | 





LOCATE can be used to scan for 2 line identifier in columns 73-80. 


Responses: | 
Verify Mode: The located line is typed out and the keyboard is unlocked. 
Brief Mode: The keyboard is unlocked. 


EOF? a 
The end of file was reached by the request xxx...xxx. To position the pointer 
Cc at the top of the file, a TCP request must be issued.: When a FIND or LCCATE 
2) request is issued after the occurrence of an end of file condition, a TOP request 


is automatically issued before the request begins. 
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3, 1.6.27 
EDIT 
NEXT 
NEXT 
Format: 
Rp ee eg ee te pe em ‘ 
t ¢ ‘ 
‘ NEXT n 
N i} 
$ e i 
Be eee to woe Soot eee eee lee. r 
n _ is aninteger indicating the number cf lines 
by which the pointer should be advanced. The 
in default is 4 line. 
Usage: _ 


ts 


_ This request advances the pointer in the file by lines. If ‘nis 0 orun- 
specified, a value of fis assumed and the pointer is advanced to the next line in 
the file. If the end of file is reached before the pointer is advanced "n" lines, 
the pointer is positioned after the.last line. Specifying a value of ''n'' that 
is greater than the number of lines to the end of file is one method of 
reaching the bottom of the file. 


"yt 


Responses: 
The keyboard is unlocked. 
EOF: - ef ae 


The end of file was reached by the request xxx...xxx. To position the pointer 


ey TD emg MOE Re a Sess 
at the top of the Tue, a tur request must be issued. 


Examples: 


aw NS 
This request advances the pointer 5 lines. 
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3.1. 6-28__7_ 
EDIT += .__ . 
4 C OVERLAY - € 
{ OVERLAY - 
Format 
¢ atatateetaselatatekatatatetatahateted tocetateteteted oe as oes aes eles "a 
: c c 
ar uae : 
| 4 t 
e . 
ART AISI Sa Al La oR i na ne a nk a 
line is an input line that overlays the 
current line. ok pers Pee ee ee ee 
Usage: 


This request takes the non-blank characters from "‘line'' and places them in” 

the corresponding position-of the current line. -Blank characters in line" do:- >” es 
not replace corresponding positions in the current line. If there is more than: ~~~ 

one space 2fter the request, te se spaces will be considered as part of ''line'’. 

The logical tab character, -the tab key, and u ne ee backs espace eueecrey can 


~—e eee 


be used in specifying ' line" . ; a Rae ee 
Responses: as | 7 € 
Verify Mode: — The changed line is typed out and the keyboard is ee 
Brief Mode: The keyboard is unlocked. : : 
EOFs oes eae 
The end of file was reached by the request xxx...xxx, For OVERLAY 


to reach the end of file, the REPEAT request had to be issued prior to 
the OVERLAY. 


atm, 


The letter ‘‘b'' 





line before request: 


is used here to indicate a single space. 


Examples: : 
a. ObbbbbbbbbING Column 
1. 9 


ee 


request: | ing, 
line after request; PROGRA: WEG 2 
€. Columns 9-11 in the current line are replaced by the non-blank characters in "'line’’. 
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‘ 3.1. 6-29 
EDIT 
OVERLAY 

b. ObSb33b9 Column 
os 13 6 

line before request: AGCDMIOP 

request o 5 33 9 

line after request: 3B33N390P 


Columns 1, 3, 4 and 6 in the current line are replaced by the non-blank Sasa in 


tt; ft tt, et 
“line’'. The letter “‘b’ is used here to indicate a single space. 


c. OD1ZC , Column 
. 4 7 13 
line before request: a ’ F10.5,110) 
request: 0 24c 


line after request: CF10.5,110) 


Assuming that a logical tab setting is set to column 7, the logical tab character # 
followed by the logical backspace character % places the next character from the 
input line into column6. The C overlays the blank in column 6 of the current line. 
The letter "'b"' is used here to indicate a single space. | 


ERE 


wees eee eh 


twee 


we 


> 
awit ee 


, 
+k meme , 
ee ty AB Rtn ME RNase Bde I 8 


: Hog) wlohe 
oN ee we oi 


pennies 


cliente era Nae 


ra) 


. ot CT en ee 
Se ne ee 
ay . 
‘ 


~ 
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: 3, 1. 6-30 
EDIT 
PRINT 
PRINT 
Format: 
faeces Seas bit ic Waar asi a 1 
t t n j 
§ gJPRINT( 1 l LINENO(; |, 
t Po { ce L ! 
7 Nemes geeipsre: ers Ue ee eee eee ly 
* n is an integer specifying the number of lines to 
- . be typed out. The default is 1 line. 
x = L ‘signifies that the line identifiers should be typed 
ats out. 
Usage: 


PRINT types out ''n'' lines from the file, starting with the current 
line. Upon completion of this request, the pointer is positioned at 

the last line printed unless an end-of-file condition occurred, in which 
case the pointer is positioned after the last line printed. If "nis 0 
or unspecified, it is assumed to be ] and the current line is typed out. 
If the pointer is positioned at the top of the file, the null line is in- 
cluded in the number of lines typed. 


If L or LINENO is specified, the line identifier in columns 73-80 is 
typed out with eachline. If L or LINENO is not specified, only the 


- non-blank characters in columns 1~72 of each line are typed out. 


The "n' is required if 'L" or 'LINENO" is to be specified. 


Responses: 


The line(s) is printed out and the keyboard is unlocked. 


EOFS 


The end of file was reached by the request xxx...xxx. To position the 
pointer at the top of the file, a TOP request must be issued. 


Examples: 


Be 


P 5 
request: PS | 
i‘ ath WRITE (6,30) 
| 30 FORMAT (' ERE | AMS) 
; : : CALL SUBl 
lines ees WRITE (6,10) 
10 FORMAT (' BACK AGAIN’) 


This request types out 5 lines. The line identifier is not included. The pointer 
is positioned at the last line typed. 
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3.1.6-31 
EDIT 
QUIT 
. QUIT 
Format: 
fc eS ae 4 
‘ ‘ 
a 
fy Qj! 
5 t 
eee e 
Usage: | 


QUIT terminates the EDIT command and returns to the CMS environment without 
causing afile to be written on the disk or making permanent updates to anexistingfile. 


Responses: 
The EDIT command is terminated and the file is not written out or permanently 


updated. 


pCa 
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3.1,6-31 
EDIT 
QUIT 
QUIT 
Format: 
NY 
The 
Usage: . \ . 


QUIT terminates the EDIT command and&returns to the CMS environment without 
causing afile to be written on the disk or aking permanent updates to an existing file. 






Responses: 
The EDIT command is terminated and the file 
updated. ; 


not written out or permanently 


Examples: 
a. Q 


request: 
response from CMS: 


pore) 
=e 


EDIT is terminated and the file is not written on the disk. - 


4-1-68 
: a 
3.1, 6-32. 15 
- EDIT 
REPEAT 


REPEAT | 
Format: 
ieg Oa ST anes rani siege | 
{ { ny ji! 
1 REPEAT ; 1 
' 5 ns ' 
bowceccelae ween Locos Sts A) 
n is an integer specifying the number 
of times to repeat the following BLANK 
or OVERLAY request. The default is 1, 
Usage: ; 


. 


This request executes the following BLANK or OVERLAY request 
"mn" times, If ''n'' is 0 or unspecified, it is assumed to be 1, If 
‘n't ig greater than the number of lines between the current line 
and the end-of-file, REPEAT will be in effect until the end of the 
file, Thus, the REPEAT request can provide globol BLANK and 
OVERLAY requests, 


Responses: 


The keyboard is unlocked, 


Example 8: 
a. REPEAT 25 


The following BLANK or OVERLAY request will be executed 25 
times, : : 





4.1.68 Go 
3, 1.6-33 [6 


EDIT 
RETYPE 
* RETYPE 

Format: 

Beige Pete te es aie air are aaa 1 

RETYPE) | ; 

R ' line ' 

ie ewovcs eases este Uocwewedessocosed 

line is an input line that replaces the current 

line. 

Usage: 


This request replaces the current line With "‘line'', The logical tab character, 
the tab key, and the logical backspace character can be used in “‘line'’". The 

line'’ is separated from the request by only one blank; any other blanks are 
considered part of "‘line'’. 


The pointer is not advanced by this request. 


¥ + 


Responses: 


The keyboard is unlocked. 


Examples: 
a. R#IREG = J + K**2 
Columns 
1 ian 44 
line before request: 1RE55 = 1 = K 
request: r #lrez = J + ke*2 
line after request: TREG = J + Kee2 


The “‘line™ specified with the request replaces the current line. Assuming that 
the logical tabs are set for a FORTRAN filetype, the statement "IREG = J + Kvek2" 
begins in column 7. 





SAVE 


Format: 


Usage: 


Responses: 





Slag aaa mae (eae Ri ae aE 1 
[filename i 


| reer. L nn ewe nee nen J 


is the name to be given to the file 
as the latest copy is permanently 
written on disk. 


filename 









The SAVE request writes the latest copy of the file on the ap- 
propriate disk and returns t the Input environment with the 
pointer positioned at the sam current line as before the SAVE 

_ was issued, If the file is being stored on the disk for the first 
time, it is written on the perm nent disk with mode Pl, If the 
file already exists on the disk, i\ is written on the same disk in 
the same mode as it previously eXisted, This latest copy replaces 
any existing copy of the file on the\disk. The file directory is up- 
dated. 


If filename" is specified, it is used \s the filename of the file. 
If "filename" is not specified, the file\ame used at the time of 
the invocation of the EDIT command is \sed. If "filename" is 

not specified at any time, a message is typed out. 


INPUT: 
The latest copy of the file has been saved on disk\and the Input 
environment has been entered. The pointer is po itioned at the 
same current line as before the SAVE was issued. 


FILE EMPTY-EXIT TAKEN 7 
The SAVE request was issued for an empty file, The, file will not 
be written on the disk and the Input environment will he entered. 


NO PRIMARY NAME SPECIFIED - RETRY 
A filename was not specified for this file, so it cannot be saved. —, 
Re-issue the SAVE request, specifying 4 filename, ) 











‘3 - 3. & 6-34 € 
ais EDIT 
esi ed SAVE 
SAVE eee. oavacls 
Format: = 
Gey ee he Pte ee ro ae 4 
‘ SAVE [filename | | 
Lwaiecuseocae Geeeeeetoe cee 3 
: filename _ is the name to be given to the file 
ieee oe SO as the latest copy is permanently 
ae : written on disk, © 
Usage: 8 So ee 


The SAVE request writes the latest copy of the file on the ap- 
propriate disk and returns to the Input environment with the 
pointer positioned at the same current line as before the SAVE 
. Was issued. If the file is being stored on the disk for the first 
—time, it is written on the permanent disk with mode Pl. If the 
file already exists on the disk, it is written on the same disk in 
_ the same mode as it previously existed. This latest copy replaces 
~ any existing copy of the file on the disk. The file directory is up- 


dated. 


co 


lf "filename" is specified, it is used as the filename of the file. 
if "filename" is not specified, the filename used at the time of 
the invocation of the EDIT command is used. if "filename' is 


not specified at any time, a message is typed out. . ot 
Responses: 
INPUT: 


The latest copy of the file has been saved on disk and the Input 
environment has been entered. The pointer is positioned at the 
same current line as before the SAVE was issued. a 





FILE EMPTY-EXIT TAKEN 
The SAVE request was issued for an empty file. -Fhe file will not 
be written on the disk and the Input environment will be entered. 


q Ce 
. < . ‘ 


3/9/70 
3.1.6-35 
EDIT 
SAVE 


Examples: 
a. SAVE filename 


request: save my 
response: INPUT: 


SAVE MY was issued to write the latest copy of the file on disk 
and give it the filename of MY. The Input environment.of EDIT 
is then entered. 





~ | | - 
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1, 6.35 
- EDIT 
‘SAVE 
Examples: =a 
a, SAVE Me 

request: 
response: RIMARY FILE NAME SPECIFIED-RETRY. 
request: ; 
response: 


SAVE was issued for a file that did not have a filename specified 
with the EDIT command, as the first respdyse indicates. SAVE 
MY was then issued to write the latest copy OKthe file on disk and 
give it the fitename of MY. The Input environment of EDIT is then 
entered, | 


x 


Format: 


_ 421-68 | 

3.1, 6-36 
EDIT. 
SERIAL 


SERIAL 


SERIAL 
SER 


(el (il | 


id specifies the 3 character identification to be used 
in columns 73-75. 


wenn ees, 


(NO) specifies no serialization or identifier is to be 
placed in columns 73-80. 


n specifies the increment for the line number. 
ms This number also becomes the first line number. 
The default value is 10. 


Usage: | 


This request allows the user to specify the 3 identification characters and the 
increment of line numbers to be used as the identifier in columns 73-80 of each | 
card image. If the SERIAL request is not issued, the standard identifier is used. | 
The standard identifier is formed from the first three characters of the-filename; the 
increment and beginning sequence number is 000140. 


If columns 73-80 are to be used for data or if no identifier is desired, the SERIAL (NO) 
request should be issued. If a file is being created, the SERIAL (NO) request phate 


be issued before any input lines are typed. Upon issuing the EDIT command for a! 


new file, the Input environment is entered. Before any lines are typed in, the user 
should immediately enter the Edit environment by typing a null line, issue the | 
SERIAL (NO) request, and then return to the Input environment by issuing the INPUT 
request to entcr lines of input. Eighty character input lines can then be entered. 


If a file already exists with no identifiers, the SERIAL (NO) request must be given: 
each time the EDIT command is issued to maintain the data that currently exists © 
in columns 73-80 of the file. If a file already exists with no identifiers and the 
SERIAL (NO) request is not issued, the standard identifier will be placed in 
colunvas 73-80. 


i 
\ 
i 
( 


If a file already exists and the SERIAL request is issued with an id and/or incre- | 
ment, the new identifier will replace the contents of columns 73-80; the replace- | 
ment will not occur until the cuxrent pointer is positioned at the top of the file or 
until a FILE or SAVE request is issued. The entire file will be resequenced 
with the new identifier, 


| 


feo ; "421-68 fo) 


a-1268 3,1. 6-38 
3.1. 6-37 ; EDIT 
EDIT sta 
faites TABDEF 3s 
SERIAL ; } 
rABDEF = 
SERIAL 
: : Format: 
Usage: (Cont.) 
; Nt a a eae ee egy ge ae ‘ 
If a file already exists with identifiers or if input lines have been t TABDEF! t chieseiee 
entered which were serialized, the SERIAL (NO) request will have i { TABD i { # } ' 
no effect and the identifiers will not be changed. Once serialization { = ' 
has begun, it cannot be nullified. PiascesiSerde ree serera reas Ste SRR 
Note: character is any valid ued to be used as the 
logical tab ch qacter: The default char- 
a. For a filetype of MEMO, the default option for serialization acter is the #. \ 
will be SERIAL (NO). That is, if serialization is desired, it ‘ : \ 
“mist be explicitly stated. ; Usage: : ; 7 
TABDIE:F redefines the character to be recognized s the logical tab character. If 
Responscs: TABDEF is not issued, the character # will be the gssumed character. 


The keyboard is unlocked. ; 
If the character # is to be used as a valid input charadger, the logical tab character 


must be redefined using this request. 


Examples: 
a. SERIAL REP 20 If TABDEF is issued without specifying any character, the logical tab character is 


The request causes REP to be placed in columns 73-75 of each card image, the reset to the character #. . 
" first input line to be numbered 00020, and the Jine numbers to be incremented by 
20. An example of the use of the logical tab character ina FORYRAN filetype is shown 
below: 
b. SERIAL (NO) : - Column 
If the file is being created, this request allows the user to create 80 character 4 7 
card images from each input line, as no identifier will be placed in columns 73-80. \ 
input line: #x = a +b \ 

If the file already exists without identifiers, the data in columns 73-80 will be : card image in file: AER aR \ 

5 \ 


maintained. If a file already exists with identifiers or if input lines have been 
entered which were serialized, the SERIAL (NO) request will have no effect 
until the current pointer is positioned at the top of the file after which no new 


4 
If the logical tab setting is set in column 7, the expression "Xe AtB' Swill begin 
serialization will take place. in 


in colunin 7 of the card image. 


Responses: \ : 
The keyboard is unlocked. ! 


Example: 
a. TABD $§ 


This frees the # as a valid input character and defines the character $ as the 
logical tab character. 


LL 








| 3/9770 
3, 1.6-38 | /9/ 
EDIT 
TABDEF 
C TABDEF 
Format: 
| iam a ta mare aa as oa BBs eee ee ey ee ee ’ 
! 
: TARO | ‘ aaa 
- 8 ‘ t 
Cae & ee 
Dos i aie eae oi i ee nee eee t 
character is any valid character to be used as the 
logical tab character. The default char- 
acter is the !, 
Usage: _ 


TABDEF redefines the character to be recognized as the logical tab character. If 
‘TABDEF is not issued, the character ! will be the assumed character. . 


If the character ! is to be used as a valid input character, the logical tab character 
_ must be redefined using this request. 


if TABDEF is issued without specifying any character, the iggear tab character is 


€ reset to the character !. 


An example of the use of the logical tab character in a FORTRAN filetype is shown 


: below: 
Column 
. 4 7 
input line: X =a +h 
card image in file: X=A+3 


If the Icsical tah setting is set in column 7, the expression ‘"X=A+B"' will begin 
in colunin 7 of the card image. 
Responses: 


‘The keyboard is unlocked. 


Example: 
a. TABD $ 


This frees the 'oas a valid input character and defines the character $as the _ 
Fogical tab character. 


fod | 
4-1-68 ‘ : 2 
3,1, 6-39 ; (0 
EDIT 
TABSET . 4-1-68 
. 3,1, 6-40 - 7) 
TABSET EDIT , 
TABSET 
Format: : 
Se tt ee eS ets pad eeeiceedenisionl Responses: 
| (TARSET ' [m1 an] \ . 
: TAB : oe 1 The keyboard is unlocked, 
boca im ci oa Liste aos eae eae | 
Examples: 
' nl,..nN are column positions for logical tab 
settings, If omitted, the default tab a. TABS 1 7 13 19 25 60 
: settings will be used. ; This request sets the logical tab settings in columns 1,7,13,19, 25, and 
Usage: 2 ; 60. 
This request enables the user to establish his own internal or logical a : 


tab settings for a card image. The request is followed by from 1 to 11 
numbers that do not exceed the value of 80, The first number indicates 
the column in which the card image begins, and the following 10 numbers 
specify the logical tab settings. 


If more than 11 numbers are specified, only the first ll are used, If 

a number greater than 80 is specified and no serialization is being per-' 
formed, input lines will be truncated to 80 characters, when tabbing 
indicates a column position above 80. If an identifier is being placed in 
columns 73-80, input lines will be truncated to 71 or 72 characters when 
tabbing indicates a column position above 71, 


If the first number, specifying the column in which the card image begins, 
is not equal to Ll, all input to the file will start at the specified column in 
the card image and all previous columns are set to blanks, The EDIT re- 
quests BLANK, FIND, and OVERLAY consider each card image to begin 
in column 1, regardless of the first specified tab value, The EDIT requests 
INSERT and RETYPE interpret the beginning column position and process 
the specified line in the same manner as input to the INPUT environment, 


The TABSET request overrides the assumed logical tab settings, such as 
for FORTRAN and SYSIN filetypes. 


The user-defined. tab settings apply only to the file during the current EDIT 
command, If EDIT is issued again for the same file, the assumed logical 
tab settings will be in effect until TABSET is again issued. 


If TABSET is issued without specifying any values, the logical tab settings 
are reset to the default settings for the filetype of the file being edited, 


iD 





- TOP 


Format: 


Usage: 


This request repositions the pointer to the top of the file, i,e,, to 
the null line in front of the user's first line in the file. An automatic 
TOP is performed by the FIND, LOCATE, and CHANGE requests if 
an end of file condition immediately preceded the FIND, LOCATE, or 
CHANGE request. 


Responses: 


< 


The keyboard is unlocked. 


Examples: 


a. TT 
The pointer is positioned at the top of the file. 








hf 
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3.1. 6-42 
EDIT 
UP : 
UP 
Format: . 
Peerers arenes (eine ae area 1 
1 (UP ‘ i 
(iy ‘ aL i 
1 } 1 { 
BACKUP ; tha 
Dee eee ae pes zm 
n is an integer indicating the number of lincs 
by which the pointer should be moved back. 
7 : The default is 1 line. 
Usage: 
The UP request is the same as the BACKUP request, See 
BACKUP. 
Responses: 


See BACKUP. 





€ 
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3.1.6-44 
EDIT 
ZONE 
ZONE 
7 Format: 


ray Cay” 


nl specifies the initial columns of the zone of each — | | 
| record which is to be scanned. The default value 


is column l. 


record which is to be scanned. If serialization is in 
effect, the default value is 71 for SYSIN, ASP360, COPY 
and UPDATE files and 72 for FORTRAN, PLI, SNOBOL, AED, 
FLOW, EXEC, MAD, AS1130, and REPS files. . If serial- 
ization is suppressed, the default value is 80. 


n2 specifies the terminal column of the zone of each | | 


Usage: 


This request will cause subsequent LOCATE and CHANGE requests 
to apply oniy to the zone of the card-image records specified 
by the integer values for starting and ending columns. 


The initial zone column, nl, must | be less than or equal to the 
final zone column, nz, and n2 must be less than or equal to 
the truncation column. ; 


If serialization is requested by use of SERIAL and the current 
zone overlaps columns 73-80, the ending zone column is reset to 72. 


Note: 
If serialization is in effect for SYSIN ASP360, COPY, or UPDATE 
files, the default value of termcol (n2} 1s. 7k, but: the .ZOus 


ending column can be set to column 72 to insert a continuation 
character in a card image. 


Responses: 
END ZONE RESET TO 72 FOR SERIALIZATION 


If serialization is in effect and the ZONE request specifies 


@ terminal column (n2) of 73 or greater, the terminal column 


is set to 72. 


4~1-68 
3,1. 6-43 
EDIT 
VERIFY 
VERIFY 
Format: 
Go NS ee Vr es eg 
1 VERIFY ' nn j 
‘ VER 4 72 ‘ 
ep, Se res ee ee E ears bee 2 
nn specifies the number of columns to verify 
, in each card-image. The default is 72. 
Usage: : ¢ 


This request turns off the br ief mode (see the BRIEF request) and 

turns on the verify mode, causing the autornatic typcout of lines 

changed or searched for by other EDIT requests, If 'nn'"' is specified, 
‘nn'’ columns will be verified. If''nn'' is not specified, 72 columns 

will be verified; this is the normal mode of operation in the Edit en- 
vironment, If a MEMO file is being edited, 80 columns will automatically 
be verified. 


The requests which are affected by VERIFY are BACKUP, BLANK, 
CHANGE, FIND, LOCAT cas and. OVERLAY. 
Responses: 


The keyboard is unlocked, 


Example 5: 


a. VERIFY 

The verify mode is turned on and 72 columns will be verified unless 
the file being edited has a MEMO filetype, in which case 80 columns 
will be verified. 


b. VERIFY 50 


The first 50 columns will be verified in each card-image, 


Fe ee ee Pe ees ES ON Dea a ne CO 


Usage: ‘, 


Note: 


11/1/68 ZF 
; 3.1.6 


- 
EDIT (07, 


ZONE 


eee a a ek ee ee ro 


C2} (sett 


ee ee ee en 





nl =specifies the j{nitial columns of the zone of each 

, record which is, to be scanned, The default value 
is column 1. ‘ 

n2 specifies the terminal. column of the zone ef each record 
which is to be scanned. If serialization is in effect, 
the default value is 71 for SYSIN, ASP360, COPY, .and 
UPDATE files and 72 for FORTRAN, PLI, SNOBOL, AED, 
FLOW, EXEC, MAD, AS1130, and REPS files. If serial- 
ization is suppressed, the default value is 80. 

: 
This request will cause subsequent LOCATE and CHANGE requests 


to apply only to the zone of the\card-image records specified 
by the integer values for startin} and ending columns. 













The initial zone column, nl, must b 
final zone column, n2, and n2 must b 
the truncation column. 


strictly less than the 
less than or equal to 


ERIAL and the current 
ene column fis reset 


If serialization is requested by use of 
zone overlaps columns 73- e0%s the ending 
to 72. 


If serjalization is in effect for SYSIN, ASR360, COPY, or UPDATE 
files, the default value of termcol (n2) is 71, but the ZONF 
ending column can be set to column 72 to insert a continuation 
character in a card image. ' 


Responses: 


END 20NE RESET TO 72 FOR SERIALIZATION 
If serialization is in effect and the ZONE request specifies 
a terminal column (n2) of 73 or greater, the terminal column 
is set to 72. 


: ; ‘08-03-67 


ca 3.1.7-1 
11/1/68 ie ERASE [tf 
3.2.6-N5 
EDIT 
ZONE: 


3.1.7 ERASE 
Exanple: ; . . , Purpose: . : 
The ERASE command deletes a file or a related group of files 
a. ZOKE 1 72 from the permanent or temporary disks. 
The initial ZONE column is set to 1 and the terminal ZONE 


column {is set to 72 independent of whether serialization . Format: 
is in effect. cae ont 
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= . . Usage: 


Filename and filetype must be specified in the ERASE command, either by name 
or with an asterisk. If the filemode is omitted, an asterisk is assumed 
meaning that the permanent and temporary directories (but not the systen 
; directory) will be searched. 


Those parts of the file identifier not specified by asterisks are used to 
search the file directories. Entries for all files matching the specified 
identifier are deleted from the appropriate directory(s), and disk space 
occupied by these files is made available for new files, 


Notes: 


a. ERASE will delete read-only files. 


, Responses: 
ERASE gives no response except the Ready message or an error 
code. See 3.1.7-3. : 
Examples: 


a. 
ERASE DLFAC MODULE P5 


' The file specified is deleted from the file directory, and its 
space on the permanent disk is freed. 


b. ‘ERASE * LISTING 


: ; All files with tHe type LISTING are deleted from the permanent 
and temporary disks. 


c. 
ERASE * * 


All user files are deleted and the directory is cleared. 





Ko 


Error Messages? 


‘BE (00001) 


E (00002) 


E (00004) 


08-03-67 
3. Ll. 7-2 
ERASE 


CORRECT FORM: ERASE FILENAME FILETYPE FILEMODE, NAME 
| AND/OR TYPE MAY BE *, AND MODE MAY BE * OR BLANK. 


the filename or type was omitted, or the filemode 
was incorrect. Correct the command. 


The file specified was not found in the user's 
file directory. 


An I/O error occurred. Processing may not. have 
completed. It may be necessary to initialize the 
‘disk again. (See FORMAT) 


. _ G-48-67 H/ 
3.4. B-4 


3.1.8 FINIS 


Purpose: 


FINIS closes one or more files that are currently open. 


Format: 


Se 
r} 


{ens 
1 \ FI 


ee ee ee ees 


aris is the name of the file to be closed. 
. An “ means all filenames. 

aria | is the type of file to be closed. 
. An * means all filetypes. 


is the mode of the file to he closed. 
An * means all filemodes P, T, and S, 


{ filemode 
cd 


Usage: | 


FINB closes one or more specified files that are open. Closing a file consists 

of writing out the last record of that file on the disk, updating the appropriate file 
directory, and removing the entry for that file from the user's active file table. 

if the filemode number is 3 or 4 (delete upon reading), the file will be erased. An 
asterisk may be used for the filename, filetype, and/or filemode to denote the 
closing of all opened files with the appropriate filenames, filetypes, and/or file- 
modes. If the filemode is not given, the first file found with the specified name 
and type is closed. The order of search for the specified file(s) is the permanent 
disk, temporary disk, and system disk, in that order. 


The specified file must already be open in order to be closed. If it is not, an error 


code will be returned by the FINS command. 


Notes: 


a, FINIS should be issued by the user when his program does not close the files 
used during the execution of that program. Files accessed by CMS commands will 
be closed automatically. 


b. Only cight files may be open in CMS at one time. Therefore, the FINIS command 
should be called from user programs in which more than eight files are accessed. 
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FINIS 
Responses: 
None. 
Examples: 


a. FINIS DATAOUT CARDS P5 
The file whose identifier is DATAOUT CARDS P5 will be closed. 


b. FINIS DATAOUT CARDS ; 
The first file found with a filename filetype of DATAOUT CARDS will be closed. 


The permanent disk, the temporary disk, and the system disk will be searched, 
‘in that order, for the file. 


c. FINIS -* FILE1 * . 
All files that are open and have a filetype of FILE1 will be closed. 


d, FINS * * * ; 
All files that are open will be closed. 


Error Messages: 


E(00004) The specified filename is invalid. It contains leading zeros. 
The file is not closed. : 

E(00003) An error occurred while reading or writing the disk. The 
command has terminated. 

E0004) The first character of the mode is iNlegal. It is not either 
P, T, S, or *. The command has terminated. 

"E(00006) The specified file is not open and therefore cannot be closed. 


The command has terminated. 
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2.1.9 LISTS 3 
) : 
Burpose: 
LiSTF has two purposes: (1) to type at the terminal the name, 


type, mode, size the : 
specifed files or (2) to create a file on the ; 
containing infccmaticn similac tc that typed at the terminal. 


Ecrmat: 

1 y o . = . + 

{ } filenate filetype filenmcde (optiontl...opticnhs) 

; LISIP | * * 

\ L I 

J Gee ee, an te a a ee 
filename . is the name cf the files tc be listed. 


* 3 an * denotes all filenames and is the 
defavlt value. 


filetype is the type cf file tc be listed. An * 
* denotes all filetypes and is the 
default value. ; 
tilemode is the mcde cf the files to be listed. 
* It may be either P, 1, S, or * . The 
* denotes all filencdes,P, I, and S. 
The default is P and T. 
Crticrs: 
EXEC creates a file cn the permanent disk ' 
(EB) containing a list of the specified files. 
SCRI will “sort" or group~together all 
(3) sicilar filetyfes 
RANE will greduce a list cf only filenanes 
tk) 
1YPE causes the list to contain crly 
(rY) filenane and filetype 
NCCE 


trancates the typed line after 





wee ee ee 


date-last-updated, and time-last-updated of 
perranent disk 


t ~ 
05/01/69 . .. 05/01/69 
. Yd 4.1.9- pee or YY 3.1.9-3 
(8) - filencde . _ Mie 3.r.9-2 36-4C | date 4G i 
: , K2-4E time “5 
REC filename,~type,-tade, and number : : 
ey ene ae ee a painted All other columns are blank. For an example of a CMS EXEC file, 
see FIGURE 3.1.9-B, in which the PRINTF ccamand has been used to 
typecut the contents of the EXEC file. 
DATE the list will contain name, type, 
(Tt) mode, size and the date the file : . rs . 
was last written (mm/dda). The CHS EXEC file is like any cther user file. It can ke printed 
fhie se the default lane: cf£fline, edited, added to, changed, etc., but its main purpose is 
to ke used with the EXEC cr $ commands. fefer to Section 3.5.3 
for a description of the usage of a CMS EXEC file, 
JIME , added tc the defaulted line will 
{T) be the time that the file was last ; 
upéated (hhymn) Responses: 
Usage: :* | If the (EXEC) cption is specified, the file CMS EXEC is generated 


on the useér's pernanent disk, and ho response will be typed at 
the terminal. 

LISIF either types out the of specified files cr creates a file 
containince the infcrmaticn. All operands are cftional. If no Aeatean Ss : . a : a 
cperand is specified, a complete list of all the files that exist If the (EXEC) cpticn is not given, the list cf srecified files is 
in the user's permanent and temporary file directories is typed typed at tke terminal. 

at the terminal. The list consists of the name, type, mode, 

numteér cf . recerds, and date the file tas last written in each 


file specified. The number of records is the number cf 800 byte AS can ke seen in the descrifticn of the opticns, only certain 
records cccupied by the file. The date is typed as month - date guantitics of each specified file can te typed by LISTF. Fach 
(mayad). ee FIGURE 3.1.9-A. ; ee has a truncating effect cn all apticns of lower priority. 

. Examples: 


Jt a filename, filetype, and/cr filemcde other than * is . 

specified, then only the file with that identifier is typed out ae LISAF 

alcng with its size. The name, type, mode, size and date of each file on the permanent 
and temporary disks are typed out. See FIGURE 3.1.5-A. 


If the filemcde is net specified, cnly the permanent and 


temporary disk directories will he examined by LISTF. If a be LIS1F * FCRTRAN {%) . 

filerode ¢f * is specified, the permanent, temporary, and systen The name cf each file that has a filetype of FORTRAN and exists 
disks will Le used. ch the pernanent or temporary disks is typed out. 

If the EXEC) parameter is specified, a card~image file is . Ce, LISIF, FILE * * (7) ; 

created on the user's permanent disk and assigned the identifier ; The mame, type, mode, Size, date and time cf each file that has a 
"CMS EXEC. Pi". If a file with the identifier "CMS EXEC P14 - filename cf FILE and exists cn the fermanent, temporary, or 
already exists, it will be erased and a new file will be created.. system disk sill be typed out. : 


this file will contain a card image for each of the specified 
files and the format cf each card image is as follows: 


d. LISIF (EXEC) ; 
the file with the identifier LIST EXEC P1is created on the 
oe Conveake permanent ¢Gisk. This. file will contain the same list of files 
me Re an . that was typed out in Example a, tut each entry in the list will 
2-3 ; 61 have &1 ané &2 placed in frent cf it. 
5-€ £2 
8-15 filenane 
V-it ; filetype . Ee LIS9F * FORTRAN (EXEC) 
37-28 filemode The file with the identifier Lrst EXEC P1 is created. This file * 


31-34 number cf records will contain the same list of files that was typed on the 
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terminal in Example b, but each entry in the list will bave 61 6&2 . “ 
flaced in frent cf it. See FIGURE 3.1.9-B. eda? “ENCES | (7 
EIIss_Hessages: ; Eurecse? 
E(CCC01) INVALID LISTF PARAMETER LIST. The MACLIE command either (1) generates a macre likrary, (2) 
An incorrect form of the command was issued. Check tc see . adds, deletes, cr replaces macros in an existing litrary, (3) 
if all] parameters are valid. lists the name, size, and location of macro definitions in a 
macre lilrery, ocr (4) Ccmpacts a macrec library. 
Be (cccc2) FILE NOT FOUND. meh ak 
The specified file does not exist on the disk. Eormat: 
( ! 1 
‘ ! J} GED litname filenarce1...filenamen | 
jMACLIE | ALI litname filenarei...filenamen 1 
i] { KEE libname macronamel...macronaneN | 
t } DEL litname macrcnanel...macronaren | 
J {| LIST libname ] 
if t | CCYVPACT liktname ] 
( ; ; GEN generates the macre litrary "likname" 
; frcem the macro definiticns in the 
specified file(s). 
ALL adés the macro definitions from the 
specitied file(s) to the existing macro 
likrary "likname". 
7 FEE deletes the existing macro and adds 
the new ccry. 
= . 2 LEL deletes the specified macre entry 
trem the dicticnary. 
& : “ ; _ COMP will ccmpact the macro likrary and 
: remove the macrces that have been 
deleted. 
ERINT offline prints the macro likrary 
Gictionary. 
x LIST types cut the dicticnary of the nacre 


litracy specified by “liktname". 


i oe et 


dl 


Jitname specities the filename of a macre litrary 


Woe La Wt od 











to be generated, added.to, or listed. 
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ME 


filenanet...filenamen specify the macro definition 
files tc be used in generating, adding, cr 
replacing in the macro likrary “litname", 
Their filetype rust be ASP360 or CGPY. 


macranamel..,necrcnamen specifies the macrces to be 
EEleted or REPlaced. 


A macro litrary is a file that has a filetype of MACLIB and that 
contains mecro definiticns and a dicticnary. A macro definition 
is a yrcuz of £360 assembler language staternents identified ky a 

‘unique nag¢ and used as an €xpansicn fer a source statement in a 
7360 assemtler language program. The dictionary is generated by 
the MACLIE ccmrand and is made up cf macre definition names, the 
indexes cr ]ccations of the macro definiticns within the library, 


“ . 05/01/°° 
YEP 4.1.10-- 
LINK 2171 23 
OPEN 2194 207 7 
PUT 2401 9 
REAL 2410 34 
SAVE 2444 84 
SPIE 2528 143. 
TIME 2671 17 
WALT 2688 - 19 
WRITE 2707 34 
Re T=1.02 


FIGURE 3.1.10-A. 


printf syslib naclit 73 86 


Exanple cf MACLIB List command. 





maclib list syslib 


BACKS ANDEX SIZE 
CUSTYEE 2 10 
CMSAVE 12 42 
CMSKEG 54 29 
MADCALL 83 21 
BADDEL 704 15 
MADTYPE 419 11 
CMSYSKEEF 130 78 
FINIS 208 7 
ROBUF 215 12 
GEN 227 11 
TYPE 238 4g 
FCB 287 20 
STATE 307 9 
CKEOF 316 5 
BDTYP 321 14 
WRBUF 335 12 
SETUE 347 8 
FRASE 355 7 
TYEIN 362 14 
RALIR 376 20 
RDJECB 396 41 
CLOSE 407 158 
DCE 565 518 
DCBD . 1083 534 
FREEMAIN 1617 223 
GET 184C 9 
EP REEPCOL 1849 18 
- GETNAIN 1667 255 
GETEOCL 2122 49 


ané the size cr runmber cf card images in each macro definition, 





FACRC, . , S¥S00739 

BLABEL CMSTYEE €MESSACE syscc740 
SLABEL LA 1, TYP&SYSNCX SET PARAKETER IIST SYS00750 
: SVC X'CAS ISSUE CALL TO TYPLIN SYSC0750 
BC . 18, TRAGSYSNDX BRANCH AROUND PARAMETER LIST SYSC0770 

: cS CF (ALIGNMENT) §¥S00780 
VYESSYSNEX CC CLB*TYPLIN' CCHUNANET NAME SYSCC790 
[c AL1(1) CONSOLE NO. SYS00800 

BC AL3 (MESESYSNEX) LCC. OF NESSAGE SYSC0810 

rc c'r RED INK,FIXED-~LOCATICN-MESSAGE S¥S00820 

cc AL2(L*MESESYSNDX) LENGTH OF MESSAGE SY¥S00830 
MESESYSNDX CDC CEMESSAGE ACTUAL MESSAGE SYST0840 
TRASSYSNOX CS) CH -_ SYS00850 


FEND SYS00860 
RK; T=C.§? : 


FIGUEE 3.1.10-E, Printout of the CMSTYPE macre 
definiticn Using PRINIF. 


Ic te accessible to the MACLIE command, a macre Gefiniticn nust first 
exist on disk ir a macro definiticn file. A macro definition file is 
a file that ccrtains card images of macro definitions written in the 
{260 asserbler Janguage, accerding to the rules for defining macros. A 
wacrc definiticr file must have a filetype of ASP360. 


The bkaclik Command furcticns ares: GEN, ADD, LIST, DEL, REE, PRINT, and 


CCKE. 


The GEN £ferm cf the MACLIE command creates a macre likrary and assigns 
the identifier "litname MACLIB Pi" to .it. ‘This macre library is 
generated from the macro definitions in the specified macro definition 
file(s) having e filetype of ASP360. 


The ACD form cf the MACLIK ccnmand appends the macro definitions fron 
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the specified mecro definiticn files te the end cf the existing naerag 2 °t0°8 f. To print the centents cf a macro definition, use the PRINTF 
library. As in the GEN form, the specified macro definiticn files must ccomand and specify the index nupber as the starting lecation ard 
ave a filetype cf ASP360 and the specified libnane must have a (indextsize-1) as the ending lecaticn cf the wacro definition. 


For an example of FRINTEF that prints the CMSTYPE wmacre 
definiticn, see FIGURE 3.1.10-E. 


ciletype of FACTIB. 


Ihe LIST form cf the MACLIB command types out the name index, and the 
size of each nacre definitict in the specified library. For an Responses: 
exasple cf the cutput form the MACLIB LIST command see FIGURE 3.1.10—-A 
which lists the CNS system macro likrary SYSLIE MACLIB. 


Ncree 
Ihe TEL £uncticn removes from the MACRO litrary directory the name of 
the specified tecre. . Fxanrples: 
The cCCKE functicn remcves any previously deleted MACROs from the ae MACLIE GEN LSLIB MNAC1 WAC2 
litcary. 7 : The macre- litrary LSLIB HACLIB is generated from the macro 


definiticrs in the MAC1 ASP360 and MAC2 ASP360 files. If the 
file LSLIE MACLIB P1 already exists, it is erased and the new 
The £RINT functicn will create.a MAP of the specified library and file is generated. aa 
tEtint it cn the offline printer. “liktname MAP Fi" will alse renain on 
the veers files. 


b. MACIIE ALD IBLIB IGSUBE 
: The macre definiticns in the file IOSUB ASP360 are added to the 
The KEE functicn will replace the existing code of the specified ; end of the existing macro library LSLIB MACLIB. 
( racic, vith the new code frem the AS&P360 file of the same name. 
Ce MACIIE LIST SYSLIB 
Notes: , The names cf the macro definitions in SYSLIB MACLIB are printed 
cut along with each macre definiticnts index and size. See 


: PIGURE 3.1.10-A. 
ae The MACLIB command does not check the macro definitions for 
errors; it assumes that the definitions are correct and that the 
. card images conform to the assenbler language input fcrrat (see Error Messages: 
Section 3.4.1). 


£ (00001) INVALID MACLIB COUMAND FURKCTICN 
te. Fach specified ASP360 file may ccntain one cr mere macro Ck FARAMETER LIST. 
definiticnrs. An incorrect form cf the MACLIB ccmmand vas given; or, the 
: parameter list is invalid. Re-issue the cCcmumand with the 
correct fcrgat. 
Ce If a MACLIE file is Leinqg generated and a macre library 
already exists with the sane identifier ("likname” MACLIB Pi), it na 
will ke erased and replaced by the library generated with the E(CCO002) . ERROR WHILE WEITING 
MACLIB GEN command. An erxer cccurred while writing the library on disk. The 
library will ke closed and the command terninated. All of 
; the irput card images that were precessed before the error 
d. No checking for duplicate macro names tetween the ASP360 occurred will be included in the file "likname" MACLIB. 
files and the existing MACLIB file is ferformed. The ASP360 
files will be added to the end of the existing MACLIB file. 


E (00003) EFROR WHILE REALING 
{ , An errer cccurréd while reading the disk. The likrary will 
e. No acre than 100 tatre definitions can reside in a MACLIB be clicsed and the command terminated. If the GEN or APD 
tile. 1f ar attempt is cade tc include more than 100, an error forn c£ MACLIE had keen issued, all of the input card images 
message will be typed out, and any macro definitions beycnd th that were processed befcre the error occurred will be 
first hundred will not he included in the MACLIB file. : included in the file "libname" MACLIE. 











05/01/69 . _, 05/01/69 
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| : eee 25 3.1611- CEFLINE 
E(CCCO4) INPUT FILE WCT IN CCKRECT MACRO FORMAT. , ‘ ; 
The A£P360 file is net in correct macre fornat--either the 
card images are cut of order, the macro nase is lenger than Purpose; 


8 characters, there is a blank in column 10, or a MEND card : 
is missing from amacro definition. The likrary will be 


closed and the ccrwmand terminated. All of the input card The CFFLINE ccpmand ccntrols the unit. record 
images that were processed before the error occurred will be infut/cutput devices. Input files bay ke entered 
incluced in the file “libnarc™ MACLIB. thrcugh the card reader. Cutput files Ray be printed, 


with or withcut automatic carriage contrcl, cr punched. 


. "“likname" DOES NOT EXIST. IGNOKED. 
An ASE3€0 input file does not exist--check to see that the Format: 
Sprecified libname has a filetype of MACLIB. 


E(CC006) MACLIB FILE SPECIFIED DOES NOT EXIST. ; { | 

The specified litrary file does not exist--check tc see that | OFFLIKE “ccmmand" ftilenase filetype <filexode> | 

tte specified litnare has a filetype cf MACLIB. { {o) 4A) i 
F(CCGO7) |. MACLIB FILE SEECIFIED NCT IN CORRECT 

FORM. 
“The syecified libnane is not a valid MACLIB file as created “ where ccnuand = ; 
by the MACLIB ccomand. 
_ REAL specifies a deck is tc be read 
E(CCCOE) ._ MACLIB DICTIONARY CVERFLCW ~- TOO MANY , fron the card reader. 
MACROS, SORRY. ; 

The KICLIE dictionary contains 100 racre nares. We mare can 

be aéded. The MACLIB file will be clcesed and the command PRINT the specified file will ke printed 

terminated. All cf the input card images ‘that were cntc the system printer with automatic 

processed Lefore the errcr cccurred till be included in the single spacing, 

File "“libname" FACLIB. 

PRINTCC the specified file is tc ke printed 

E(CO0009) © X¥XXXXXX NCT FCUND IN LICTIONARY. with the first character cf each record 

The wecre xxxxxxxx dces nct exist in the specified macro interpreted as a carriage contre] 

likrary. The MACLIB ccrmand is terminated. On macros in the character. 

ASF3€C tiles that were in front of the macre xxxxxxxx have 

been teplaced in the macre library. 

PRINIUPC the records of the nased file vill ke 


: translated tc upper case, then printed. 
£(CCC1C) REPLACEMENT FILE NOT FCUND. : 


PRINTVLK © the specified, variable-length file 
Will ke printed. 


PUNCH the specified file will ke puncked onto 
the system card punch. 


PUKCHCC and “CEFLINE REAL filename filetype" 
centre] card will be inserted ag the 
first card prior te punching the specified 
file. . 
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filenane filetype <filenode> 


identify the file to ke transferred. If 
filenode is cnitted for a READ, F1 is 
assuned. For cutfut oferaticns, if filenode 
is cuitted, the pernanent, tenperary, and 
‘system disks will te searched fcr the f£ilé. 


identificaticn card with CE67USERID frinched in the 
first 10 columns, and the user's identification 
Starting in the 13th cclusn. CE will save the deck 
until the user logs on and requests it sith an OFFLINE 
FEAL ccnwand. If more than cne deck has been read Ly 
CE, they are frocessed ty successive OFFLINE READ 
cotmands in the crder they were entered. 


futrute: 
For the CFFLINE PRINT, PRINICC, PRINTUEFC, PRINTVLR, 


* specifies that filenaze, filetype, and FUNCh and EUNCHCC comrands, filenare ané filetype must 
filemode will be fcund in OFFLINE READ ke specified. If tke filencde field is blank, the 
ecntrol cards in the input card strean. Fermanent, temporary, and systen disks are searched, in 

that ocder. Asterisks are not permitted in any field. 
Usage: 


dngeut: 

If filenane and filetype are specified with the OFFLINE 
FEAD ccarand, cnly one file will be read in. A 
Ereviously existing file with the same identifiers is 
erased. If fileucde is onitted, Pi is assuned. If 
filencde is net specified, the fied must he left blank, 
an asterisk is net accepted. 


If the file designaticns are to tke entered in the card 
‘sstreap, a single asterisk must he specified with the 
CFFLINE READ command instead of filenare and filetyre. 
The deck entered threugh the card reader nay contain 
any nurber of files, each insediately preceded by a 
card centaining an OFFLINE FREAD ccntrol card specifying 
the filenare, filetype, and cptionally, filercde. The 
ccurané nust start in the first card colunn. These 
centrol cards are typed cut at the terninal as they are 
enccuntered, and are interpreted by the system just as 
if they had been entered fron the tercvinal. Any 
existing file with the sare identifiers as those 
gepecified cn one of the GEFLINE REAL cerds is erased. 
Fach ccaenand card ends the file preceding it, and the 
last file is ended. Ly the end cf the card deck. 


If an “OFFLINE READ * " ccornand is issued, and the 
first card cf the input stream is net cf£ the ferm 
NOFFLINE FEAD filenase filetype", a file identified as 
S D>NAMEC< © D>TYEE<< P1 “ will be created containing 
all cards read in until ancther OFFLINE READ control 
card or an end-of-file is encountered. This terrorary 
file nay new be altered ts the desired filenane and 
filetype. 


When oferating on a virtue! machine, veer card decks 
Bust be read in by CE bef<re an OFFLINE READ connand 
can ke issued. The user reed net be legged on at the 
time the decks are read in. Each deck sust be entered 
separately, and each gest be preceded hy an 


The OFFLINE PRINT ccnrand prints the specified file 
with single spacing and CHS page teadings ccntaining 
the file idertifiers and a page nunber. Up to 55 lines 
are printed cn a page. If the file keing printed has a 
filetype cf LISTING, it is printed as if PRINTCC were 


issued. 


The CFFLINE PRINTCC ccnwand uses the first character of 
€ach line in the file as a Carriage ccntrcel cede. The 
waxinus line size, including the control character, is 
133 characters. A klank (hex'40') ain the cenatrel 
fositicn causes the line tc he followed by a single 
Space. A zere (hex "FQ') céuses a sinole space befcre 
anc after the printed line, A one (hex *F1') causes a 
ekip tc the top of the next page tefcre the line is 
Frinted, and a single space after the line. Ancther 
value in the contrel tELyte is assuned to bea valid 
channel ccnmand code, and is filled irto a CCH. No 
teadincs cr page nunbers are supplied ard no autonatic 
skip is performed at the end of the page. 


CFELINE ERINTIUEC will perfcro upper case translaticn cn 
all reccrds cf the specified file. For exanple, if a 
file cf type SCRIPT oc HEYG is to te Frinted and the 
correct printer character chain iS rot available, 
ERINTUEC. will print the file in uprer case, eliminating 


all print checks and carbeled characters. 


CEFLINE ERINIVLR wil] print variatle length cecerds 
Froduced Ly an OS access sethcd. The printatle data of 
the reccrd is preceded by a fcur-byte ccntrol field 
which contains the length cf the record. this field is 
Cisgardéed ard the reccrd frinted under the PRINTICC 
format. 


fhe CGFFLINE PUNCH ccmménd accepts reccrds uf ta 80 
characters in length. Shecrter records are padded to 80 
characters with blanks at the right. 
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“CEFLINE EUKCHCC command will insert ag the first card 


cf the specified file tc be funched, a “OFFLINE 
READ..." control card. The punched deck can now ke read 
ty means cf a “OFFLINE READ #" cenmand. 


Netes: 


a. Files handled by the OFFLINE comrand must have 
fixed-length records, except for OFFLINE PRINTVLR, 
which handles variable length reccrds. 


kr. Only the first card cf any input deck is checked 
ter .CEF67USERKILE. CP frocesses all cards follewing it 
until a physical eni-cf-file as a single file. 


c. If the file being frinted with OFFLINE PRINT has a 
filetype cf LISTING, it is printed as if FRINTCC vere 
specified. 


d. Under CE, printer output is preceded by a single 
line ccntaining a USERID. PUNCH output is preceded by 
a card containing a USERIL. 


ae. OFFLINE READ filenane filetype filerade 

After the command "CEEFIINE HEAD?" ccntrel cards 
enecuntered in the ingut card stream are typed at the 
terminal. 


Es REACER EMETY OR NCT READY. 

fhis respcnse and the Ready nessage follow an OFFLINE 
REAL congand if no card deck has been entered for the 
user's USEKIC. 


Ce 

The Ready sessage indicates the ccunand has completed 
withcut ericr. It does not mean that physical cutput 
haS cornpleted. ‘The cutput file may be held by CP until 
cther users free the cutput device, 


d.. "CEELINE REAL..." CCBIBCL CARD IS MISSING. 

‘ THE FCLLICHLING ASSONEL: 
This respense and the assuned ccntrol card are typed 
whenever an "GFFLINE BEAL *" command is issued and the 
first card cf the input gtrcam is not an "CFFLINE REALE 


filenane filetype <filemode>" control card. 


€. (NULL FILE) 
Attempt tc read a file containing no reccrds was nade. 


Fxamples: 


” ie OFFLINE READ SEC23 SYSIN 


Any previcus file with the filenaze and filetype SEC23 
SYSIN is erased. All cards follcwing the CEG? 
identificaticn card are glaced in a tile on the 


Fermanent disk identified as SEC23 S¥SIN Pi. 


k. OFFLINE EAL * Assume the follcwing deck has 
keen entered Ly the oferatcrs 


mee ce ce ee cae ert ee em me a Oe en ce Sere ae lr ee ae Na NN 


/ 


Pode p Sy atin Pe Uae Sates ese 


data cards i 
EET, | Soir OSEAN aa ese ns Pee Or ee SEC 
/GRELINE REAL FILE DAC2 PS i 
mel oct oke Gdn eee eeere oe 


/ / 


PE Booed ate ga inet Sas gh see ate te SY, 
7source cards 1 


cower ee Yn ere tee ee a cee re a le ate ea ene me sate mr a are Sa A eH ee 


/CEELINE READ SCKIJ FORTRAK “y 


! 
JCEGTUSEBIL JAYEFE ‘Y 
| | 


Any previcus files with the identifiers SORTJ FORTRAN 
cx FILE fAQZ are erased. Tke card rececrds are placed 
in files cn the permanent disk under the 
identificaticns SORIJ FORTRAN P1 and FILE DAC2 P5..- The 


£cllcwing response is typed; 


GEFLINE REAL SCRTJ ECRIEAN 
CPFIINE HEAL FILE LAOZ 


Ce. OFFLINE PRINI FILE CAaCz 

A search is nade fer FILE EPAO2, on .all three disks, if 
necessary. When it is located, it is frinted out with 
Single spacing and CuS-supplied fpage headings. The 
first page of the printcut will contain cnly the 
USERID. The seccrd page will start with the following 
heading; 


FIIESFILE TAQ2 P5 CAEBRILDGE NCNITOR SYSTEM 


—_ 


ge 05/01/69 
LY 3.1,11-5 [27 


05/01/69 


Be a 
KEE 9111-6 05/01/69 chat, 

LE” one : = ty 

EAGEOO1 pee 3.1.11-7 £73 


i el 


The heading is follcued ky a Elank line and 55 lines of ; 
the file. The heading cf the second and subsequent Figure 3.1.11-A. Output produced ty an CFFLINE PRINICC ccrmand. 


Fages is the sane, except fcr the page nenber. 


ee eet oe ie ae es das oe 


de CFFLINE PRINTCC EX FILE BS ' 7 
See Ficure 3.1.11-A belcw, thich ehcws the contents cf ne 
the file EX FILE P5, and the printed output produced hy E(CCCO1) INCORRECT COHEAD LIST. 


this ccurand. a. The operaticn syecified with the command was 
; invalid; it must te cone of these: READ, PRINT, 
PRINICC, PRINTUPC, PRINTIVLR, FUKCH, o£ EUNCHCC. 


an las est os ess Dawns St Sia Sate anc op a a es aah dla eet ay as ee nae, Macs alan ak es Sees b. ko filename (ner "*#" under the special READ 
ile Centents otes Output mcdé) was specificd. 
tile_centents Hotes SHEDS . Cc. Filetype was.specified as an "%", That's a 
1 {he USERID always precedes JUSEBID { ne-ne} . 
j + ; Printed output. It is ! 1 : 
f€cllcwed by an autonatic : 
pace nerd | F (00002) FILE NCT FCUKD, 
| 7 i The Eile specified fcr output dees not exist. 
| a 6 > Ad" here would have }TITLE | Check spelling of the filenare and filetype. 
{ an extra tlank page. { i] 
0 : 

0 i [ae et co ee ae a ee em cs > Fach ugh generates tuc E (00006) PRINT (max= 133) or EUNCH {max=80) RECORD 
{0 HEALING) blank lines, cr a line | i EXCEEDS sane 
i fcllcwed ky a tlank line.  {|HEADING | MAXIMNUE LERGIH south 
I LINE | i The reccrd length of an output file is greater 
! Lik bodeseseetecusce > Ko carriage-control | { than 132 characters fcr ERINT, or 133 characters 
} CLIXE character causes } } for EBIKTCC. This is lenger than a printer line. 
{ Single spacing. { J 

UR-EEALCING : ; LIN . 
LIKE icine The CEPLINE PUNCE ccmmand accepts recerds cf 80 
] LIME | LINE i characters cr less. Iseving an EDIT cormmand fer 
| : | ! the file and re-filing it truncates records to 80 
JTEAGE THC | SUB- HEADING } ChARAGrers: 
| 0 ; | I . 
CEEADING : 
LIKE oe § (00007) FRINT or EUNCE EBROR 
\ LIKE {LINE | Systen hardware failure has cccurred. Retry the 
JOLIKE i j cferaticn cn the specific unit reccrd device. 
1c EXANPLE | | ; 
| LINE I \ 
| LIKE The "1" forces a skip to [PAGE THO | ] F (C0008) ; READ or WHITE DISK EE&FOR , 
{ ; the next rage kefore the i 1 A disk I/O error has cccurred. If reading disk: 
| line is printed. \ | an illegal mcde say have been specified, atterpt 
| | HEADING 1 to output an enpty file, attenpt te ofen nore than 
| \ j eight files at one tire, cr net having enough core 
{ {LINE | Space fer the cutput tLuffers. If writing disk: 
i {LINE | the specified ucde cn tha READ ccrmand might be 
\ {LINE | illegal, or no more disk space is available. 
1 The carriage-ccertrol { EXAMPLE } 
{ character must te in { | 
j column 1, regardless {LINE | 
j of the position of JLINE | 
1 the text. | | 
] | ) 
! | | 








c 


ae | - 02/06/70 


3.1.11-8 . 


Additional Notes: 


1. 


With the CP capability of "YTER OOE" a user can receive 


£iles in his virtual card reader which have a logical 


record length of 132 bytes. If the file is transferred 
via OFFLINE PRINTCC or if its FILETYPE is LISTING, the 
first character of each record is assumed to be. a Carriage 
control character. therwise, an extra character (blank) 
is added to the beginning of each record,i.e., CMS 
Supplies the carriage control character. When the file 

is read in, the first character is icnored. 


In order to preserve the carriage control ‘2 a LISTING. 
file, the user must first alter the FILETYPS to other 
than LISTING, and then issue an OFFLINE PRINT, not. 
PRINTCC. The first character of each record is one 
treated as a part of the file. 


7-19-68 30 


3.1,12-1 
PRINTF 
3.1.12 PRINTF 
Purpose: 
The PRINTF command types all or part of a specified file at the 
terminal. 
Format: 


Pe ee Pes Tp eee Beer rer Ss cere sma e oe ee my mm ae 


Ct ee Asante am ed a Ke wet 


filename filetype specify the file fo be typed. 


nl is the line number of the first line to be typed, 
no 0 is the line number of the last line to be typed, 
n3 is the maximum number of characters to be 
typed on a line, if the records are to be 
truncated. 
Usage: 


The filename and filetype must be specified. If the first line number 

and last line number are omitted, or specificd with asterisks, the 

entire file will be typed out. An asterisk in the first line or end line 
. fields specifics the beginning or the end of the file, respectively. 


Typed lines are truncated to the specified limit, if any, or to 113 
characters if the filetype is LISTING, to 80 characters if the file~ 
type is MEMO, or to 72 characters if the filetype is not any of the 
above, If a limit is specified, the first line number and last line 
number fields must be filled, either explicitly or with asterisks. 


The search for the file is made on the permanent, temporary, and — 
system disks in that order. Jn the case of files with duplicate file - 
name and filetype, only the first file found will be typed out. 


Notes: 


a. The first line number and last line number must not be greater 
than 9999, and may not contain imbedded commas, 


b. The first character of each line ina LISTING file is not typed, 
This‘is a printer carriage-control character. 
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3.1. 12-2 
PRINTF 


ad 


c. The KT and KE commands override any specified last linc number 
or line length. 


Responses: 


The specified lines are typed out at the terminal, followed by the 
Ready message. If the Ready message appears with no typed lines, 
the specified first line number is beyond the end ofthe file, 


Examples: 


a. printf go exec * * 80 tg 

The entire file "GO EXEC P5'' is typed out. Lines are truncated to 

80 characters, As shown in Figure 3,1,12-A, the command "printf 
go exec" produces the same output except that lincs are truncated to 
72 characters, 


b. printf syslib maclib 104 118 72 

A macro definition from "SYSLIB MACLIB SY"! is typed out. by 
specifying its first and last line numbers in the file (obtained with 
the MACLIB LIST command), The line limit of 72 characters 
truncates the serial number in columns 73-80 of each line. See 
Figure 3,1,12-B. 


c. . printf fortj listing 33 * 72 
The 33rd through the last line of the file "FORTJ LISTING P5" are 
typed out, truncated to 72 characters. See Figure 3,1.12-C. 


Error Messages; 


(00001) CORRECT FORM IS: 'PRINTF! FILENAME FILETYPE 
STARTLINE ENDLINE LINE-LIMIT, 
WHERE 'STAR TLINE', 'ENDLINE', AND 'LINE-LIMIT! 
ARE OPTIONAL, 
The filename or filetype was omitted, or one of the aptional 
ficlds was not valid, 


E(00002) DISK.ERROR, 
An I/O error occurred. It may be necessary to initialize 
the disk again {see a 


E(00003) FILE NOT FOUND. 
No file with the specified filename and filetype exists. may 


: 7-19-68 

printf so exec 3.1,12-3 

ere PRINTF 
S$ o2T 
R; T=0.03 
printf mo exec * * 80 
LOAD 41 s GO 00010 
START GO 00020 


R; T=0.03 


FIGURE 3,1.12-A, Two examples of PRINTF commands which 
type out an entire file, . 


printf syslib maclib 104 118 72 


MACRO, 
RLABEL MADDPL © &COMM=*,&NAME=*,&TYPE=*, 8MODE=P1,&1TNO=0,XBUFFe*,&SIX 
ZE=80,RFV=F,&NOIT=1 
RLASEL DS Tt) 


SLABEL.COMHY DC CL&'acoun' COMMAND x 

SLASEL.NAME DO CLE'SNAME® FILE-NAME 

MLASEL. TYPE DC CL8'STYPE' FILE-TYPE 

ALABEL.HMODE DC CLZ'AMODE, ' FILE-i0DF 

SLACEL.ITNO OC H'AETNO! ITEM NUMBER 

SLABEL. BUFF DG ACSBUFF) BUFFER AREA 

NLABEL.SIZE DC ACAaSIZE) ’ BUFFER SIZF 

SLABEL.FY 0¢ CL2'RFV! FIXEN/VARITABLE FLAG 

SLAPEL MOIT OC H'ANOET! NUMBER OF ITEMS. 

ALASEL.NORD Dc F‘O0!' NUMBER OF BYTES ACTUALLY REAR 
NEND 

R; T#0,07 


FIGURE 3,1,.12-B. A PRINTF command which types out a 
macro definition, 


printf fort] listing 33 * 72 
FORMAT STATEMENT tiAP 
SYMBOL LOCATION SYMBOL LOCATION SYMBOL LOCATION 
5 38C 20 392 8 398 
TOTAL MEMORY REQUIREMENTS OO057E SYTES 
R; 120.353 


FIGURE 3,1,12-C. A PRINTF command which types out the 
bottom of a FORTRAN LISTING file. 








fn | ; | a“ ; , a 
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3.1.13 SCRIPT Jag 


CFFLINE prints the edited and fornatted 
Purposes OF - output cf SCRIPT PRINT on the offline 
The SCRIPT ccenand pecferns three functicns: (1) it creates a printer instead of at the terwinal. 
file on disk of wariakle length records fror successive terminal 
input lines, (2) it mcdifies these files, and (3) it types these : 
tiles in a format specified by included control words. FAGERXX causes printcut to start at page xxx, 
Format: SINGLE after cne page cf printed output 
Te, : ; SI SCRIET ERINT terminates, usually used 
Oh al ee ee. eh a SS cls a eh a eh er) ee ee es ee RS ee ‘ in conjunction with the PAGExxx option. 
1 | ! ! ; 
} SCRIET J ELIT filename ] 
1 SC j ELINT filenare {ofticnt...oftionn) ] STOF causes a pause at the totton of each 
j I ; I ST page during SCRIPT PRINT. 
EDIT specifies that a file is to be : TRANSLATE translates lower case Jetters te 
created cr wodified. If the file TR upper case in printout. 
exists, the user is placed in the 
SCRIPT EDLI2 environment. If it does 
not exist, the user is placed in the ‘s UNFORMNATTED the input SCKIPT file is printed 
SCRIET INEUT envirennent, so that UN along with control werds, the centre] sards 
the file may he created, are igncred and fornatting does not cccur. 
PRIKT formats and outputs the specified : Usage: 
Pp . Eanuscript file ontc the terminal, 
the offline printer, ct intc another file. is Filenare must be specified with the SCFIET command. The filetype 
SCRIFY igs assumed. Files’created by the SCRIPT ceorrand have the 
filercde P1, but existing input files te SCRIPT EDIT may have 
PILESXAKE specifies a file with a filetype ncde letter £ or T, and mede numker 1 cr 5. SCRIPT PRINT accepts 
of SCRIE%. any filenode. oe ee 
fhe SCRIEL ELIT version of this ccnmand places the user in cre cf 
tuc envircnnentss The Script Input environrent or the Script 
Cpticrs: , Edit ecnvironrent. In the Script Input envirennent, a file is 
2 ane CENTESB causes offline cutput to be centered . created or expanded by adding successive terninal input lines. 
CE cn the printer paper. ‘In the Script Edit envircnnent, existing files whose filety},e is 
SCRIPI can be exasineé and pedified. Wultiple passes can ke made 
threugh the Lile, adding, deleting, cr replacing lines. The 
FILE’ prints the edited and fcernatted output _ Script Edit envircrrent accepts typed requests that specify an 
FI of SCRIFT EBINT into a file naned: creration on a line, or a gove to ancther position in the file. 
e* "J,filenare" instead of at the terninal , 
or cf£fline printer. 
The SChIET PRINT version of the SCRIET ccrrand exanines each line 
: cf the file for ‘forrat centrel words, which are. identified as 
NCWAIT starts SCAIET ELINT cutput : Jines which begin with a pericd, and types out the file according 
NC inkediately without waiting for tc the fcrnat specified. 
the first page to ke adjusted. 
: The SCRIPT ELIT requests are descrited individually reginning cn 
NUMEER prints in the left marcin the SCRIP Fage 3.1.13-@ and SCRIET ERINT £crrat cextrol vords are described 
RU filerare and line nunker corresponding , individually beginning on Eage 3.1.13-24. Franples of a SCKIPT 


to each line cf printed cutput. file and SCRIPT PRINT cutput are shown in Figures 3.1.173-A and 





SCBIPT 05/01/93 
EU 113-3 
3.1.13-B, beginning cn EFage 35.1.73-44. (3a 
Script Input Enyjroanents 
the Script Input environment. iS entered when a SCRIPT ELIT 


- deleticn symbols are 


i 


ccmmané is issued specifyirg a file 
alsc be entered 


that does not exist. 
fren the Script Edit environnent 
IMEUT cr the BOTTCH reguests. Whenever this environnent is 
entered, the respcnse "INPUT:" ais typed and the keyboard is 
unlccxed to accept an input line. As each input line is entered, 
it is added to the file, and the keyboard is unlocked to accept 
the next line. 


It nay 
by issuing the 


fhe @ and ¢ symbols are deletion characters in this envircnorent. 
An @ synkcl deletes itself and the preceding character. Several 
ccnsecutive @ syntols delete an egual nunber of preceding 
characters. The ¢ synkeol deletes itself and all characters 
Freceding it cn the Jine. The character imrediately following 
the ¢ synkel is effectively at the left rargine Any other 
character on the keybcard is a valid character, including the TAB 


key and tke EACKSPACE key. 


ae 


the eaxinun length cf an input line is 120 
included in the line, up 

nay te entered, sec leng as the effective length after deletions 
is 12C characters cr less {including backspaces). Any line 


lenger than 120 characters will ke truncated. 


characters. If 


Hackepaces and underlines are included in the 120 
character lirit (a CEYCNS linitaticn, net a SCRIPT Llimitaticn). A 
line ccnrsisting cf 40 underlined ‘characters occupies 120 
characters. A longer line would be truncated with no warning 
ressageé by SCRKIET since it operates indcpendently of the CP/CHS 
truncaticn. 


The only exit freee the Scrigt 
Fdit environment. 


Input enyironsent is to the Script 
This exit is taken when a null line (a line of 


length 0) is entered. A null line jis generated whenever a 
Carriage return is typed while the carriage is already at the 
left margin. The null line dces not tecone part of the file.’ 


Eecause the rull line is the cnoly executicn control in the Script 
Input envircnwent, it is always necessary tc ge tc Script Fdit to 
save a file cr tc return tc the CHS Conuend environnent. 


Script Fdit Povirenpents 





ee ee 


This ervirenrent is entered fren 


the Script Input environnent by 
typing a null line, or directly 


fron the CiS Ccrrand environnent 


ty specifying an existing SCRIPT file with the SCRIPT ELI 

conrand. In cither case, the respense “EDIT:" is typed, and the 

keybcard is unlocked tc accert a SCRIP1 ELIT request. When a 
a 





to 132 characters 


‘Edit envircnrent. 


SCRIPG 


until the action 
freed, ancther 


keyboard is locked 
scecn as the keys are 


request is entered, the 
specified is conpleted. As 
request way te entered. 


whencver the user is in the Script Edit environnent, a pointer is 
naintained specifying his current pesiticn in the file, of the 
“current line", SCRIPT EDIT requests perform cperaticns on the 
cucrent line, cn the geinter, cr cn both. 


hhen the Script Edit environrent is entered fron the Script Input 
cnvirerment, the current line will be the last input line 
entered. When the Script Edit environsent is entered fror the CHS 
Ccnuand environment, the peinter is fesitioned at a klank line 
preceding the first line of the file. This line is part of the 
file only in the Script Edit environment, and is not stored with 
the file. It may not be wodified cr deleted, but it allevs lines 
tc be inserted at the top cf the file. 


throush the file. Successive 
nade ky using the TCP reguest, 
at the klank line preceding the 


descriptions for the action of 


The pointer .always mcves forsard 
fasses through the file can be 
which reresiticns the feointer 
file. See the individual tecvest 
each on the pointer. 


keguests may be entered in upper or lower case. The first letter 
cf a request is sufficient te uniquely identify the request. Fon 
exanyle, a single "t" cr any line beginning With "f" would 
specify the TOP request. Requests which pay include nunkers must 
ke separated fren the sunker ty at least one blank. 


Ikree cf the SCRIPT EDIT reguests provide exits from the Script 
FILE stores the current ccpry of the file on 
disk, and ceturns to the CMS Command environment. QUIT returns 
to tke CHS Ccsrand envircnaent without saving the current copy of 
the tile. INEUT exits to the Script Input envircnnent. 





05/ 


MBO 31.13-4 
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_ 08/01/ ~ : . Viei di 
SCRIPT C47, 4.1.13-5 SCRIPT 05/61/69 
é LA 3 . 
SCRIPT PRINT: wf , i in 
3 be oA & synkol or 4. synbo) inzediately followed by a carriage 
when the SCHIET ERINT ccenand is issued, the specified SCRIPT on in the Script Ingut envircunent does not generate a nuil 
file will he typed either at the user's terrinal, on the offline ey and no exit to the Script Edit environnent will be taken. 
Erinter, crinto a files Execution is ccntrelled by format ‘The carriage must be physically at the left margin for a carriage 
ccentrc] words included in the specified SCRIPT file. When the return ta generate a null line. 


tile is locatéd and typing is ready to Eegin, a respcnse is 
typed, and execution pauses until a carriage return is entered at 


the terminal unless the NOWAIT, GFFLINE, or FILE cpticn has been C- ‘dhe TAE key generates an acceptable character in the Script 
specified. ‘his pause allcws the user to position the output input environrent, and is retransmitted by SCRIPT PRINT. The 
paper at the top of a page. If STOF is specified with the bumber of spaces actually skipped on print output is dependent on 
cormand, the fause is repeated at the bottom of each page, the legical tab setting specified by the .1B cemmand. For 
allcwing the user to change paper iff ren-continuous forms are, indentaticns, the .IN cx .CF contrc] words should ke used 
teinc used. Jf STCE ig used, the paper should be positicned te instead of the TAB key. 


the first line to ke printed, the heading, rather than to the 
Ehysical tcp of the page. Typing will resure when a carriage a ue 
return is typed. » The SCRIET command ewploys two work files during execution. 


They are ({INFUI1) FILE £1 and (IREUY2) FILE Et. If a previously 


qhe TRANSLATE option is needed if output ais to he directed to an existing file’ is being precessed, the scde P1 is replaced by the 
cffline printer that is net equipped with the upper and lower acde cf the _ingut file, These files are normally erased on 
case letters (TN-chain).» In conjuncticn with the UNFORMATTED ccpwanc¢é ternminaticn. One cf them replaces the previcusly 
ceticn, TRANSLATE provides a means cf printing the criginal existing file, if any, just before centrel is returned te the CHS 
SCLIET file cna printer that dees not have the Tiechain {this Ccnnand envircnnent. In cases of a sachine or line failure 
cannct be dere by the regular "“OFYFLIKE EELNT"® CMS connmand). Causing an unusual termination, all or part cf an edited file ray 

re salvaged fren (INPUT1) or (INPUT2). If a previously existing 
THe PAGExxx cption in conjunction with the SINGLE option provides _ file wos keing processed, it still exists as though no changes 
a weans for selectively fcrmattiog and printing pertions of a had keen wade to it. 


Ranuscript. The xxx represents a J3-dicit page number and pust 
include leading zeros (i.@., fage 12 only should he requested by 


“SINGLE PAGEC12"). Ancther neans of selectively manipulating a €. Input lines tc SCRIPT CIT are scanned and canonicalized with 
formatted wanvecript is to use the FILE ‘cpticn te generate the respect to underlined and averprinted cheracters. This precess is 
entite cr relevant ferticn cf a manuscript into a file and then *explaingd in detail in CSC Repert 320-2023, “SCRIPT: &n Cnline 
use the CMS tacilities cf EDIT andyvor PRINTF to process it. Fanuscrife Precessing System". 


Each line read frees the disk file by SCHIPT PRINT is inspected 
for a first character of ".", which identifies a format control 
word. Fcrmat centrol swords are not typed, but are interpreted to 
epecify charges in the cutput format. Control words may ke 
entered in upper or lower case and shovulé ke separated fror their 
cperands, if any, by cne cre nere blanks. 


Control words may appear at the beginning of -any line. in the 
file, with changes effective below the. points at which they 
CcCCUL. Ke input data should te included on lines centaining 
ccentrol werds, since this Jata could in some cases be lost or 
interpreted as an operand cf the centre] word. 


a. ‘dhe Script Edit and Script Input environments shonld not be 
cconfused with the Edit and Input environments accessed by the 
EDIT cecmrand. Althcugh wany cf the SCKIET EDIT and ELIT reguests 
are Similar,. the action taken is net always the same. 











SCRIPT 
Resperses: 
SEM --- SEPT. 1968) 
this response is typed \whenever the SCRIPT connmand receives 
centre]. (SEM is an acrony\ for SCRIET ENVIRONMENT NODULE.) With 
. SCRIET PINT a pause feNcws this response until a_ carriage 


return js typed unless the WAIT option bas heen specified. 


INEUTS é 
This response is typed whenever the Scrist Input envirgfnent is 
ertered. : f 
ELIT: : / 
% 
This respense is typed tshenever the crizt Edit /environment is 
entered. 


we 


INVALIC SCRIEFT EDIT CCMBAND 


- 
es 


The request just specified was either not a yaYid request word or dia 
net contain a valid operand. Refer to e description cf the 
ndavidual reguest for its proper fernat. 


IOAD PAFER; HIT RETURN 


IPT PRINT conmand is issued 
The carriage return must be hit 
eo continue. The papfer shculd he 


\ 


This respense is given whenever the §S 
withcut specifying the NOWAIT cpticn. 
in creer for SCHIEFT EFINT freocessing 
adjusted as descriked above. 





Frror Fessages: \ 
E(C€C001) CORRECT ECRM AS:"SCBRIET" NELIIMPILEYAUE. 
Nc filerane was specAfied with the SCKIPT DIT coonand. No 
action was taken. \ 
E(CCCO2) CISK ERROR. 
An Iyc errcee ccurred. If the file existed befcre the 


cogcnand was i 


ved, it has not been changed. 
reguests. S¢ ; 


Nete d. 


y any editing 


\ 


E (00004) I} ' 


CRRECT PARAMETER LIST 5 
Ar inval parameter. kas been specified for a Acnipt PRINT 
centrelAvord, cr a reguired parameter has been omitted. The 


SCKIET/ERINT command has heen terginated. 


E(COC08) FILE xxxxxxxx KCT FCUND. 





05/01 39 
COG? 3..43-7 


139 








. 05/01/69 
Yate 
SCEIPT UE 4.1613-8 
Neo SCRIPT versicn of filenane zaruxxxx vas found. The 


SCHIET PRINT connand has keen ternirated. 


E (00012) DISK EBRCHK WHILE BEALING 
A disk error was incurred by SCRIPI PRINT. The SCRIPT PRIKT 
ccmmand has been terninated, and the disk file being printed 
will remain unchanged. 


EF (00C1€) ILLEGAL CCNIBOL CARD ENXCOUKTESRD. 
An unreccgnizable ccutrol] werd was 
printing a SCRIPT file. The SCRIET PRINT 
terrinated. 


encountered while 
connand has been 


E (00024) PCKE THANK EIGET ACTIVE PILES ~ REDUCE KESTINKG. 
This gessage will be given by SCRIPT PRINT when more than 
seven INBED ccnotrel ucrds are encountered in the SCRIPT file 
being printed. All open files will ke closed and the SCRIPT 
PRINT command will te terninated. 


E (0066S) CORRECT FORS IS3 "SCRIET? CCGCHMAND NAME 
WHERE COZHANSDT IS *EDIT! OB "PRINTS. 

The conmmpand was not SCAIET EDIT or SCRIPT PRINT. 
- was taken. 


No action 


For all of the errer nessages fron SCRIPT PRINT, the 
fcllowing message is printed: 


ERROR OCCURRED AFTER BEADING XXXX LINES. . 


This usually assists in finding offending error in SCRIPT 


file. 
E(CCCOC) *ee A TERMINAL ERRCK HAS CCCURREDL WHILE 
PROCESSING ON OR AROUNT LINE xxxxxxxx 
4% BIC. 
This message indicates a systen errcr. The appropriate 


personne] shculd te inforned of the circunstances. 
this ccnditicn can be bypassed by diagnosing the 
the errcr and changing the SCKIPT file. 

Requests: 


Usually 
cause of 


Feguests are issued to the SCEIPT ccmnard only when the user is 
in the Script Edit environnent. These requests allow the user to 
tanipulate and edit SCSIPT files. If requests are issued in the 
fcript Input environment, they becone lires cf input to the file. 


‘N 


operands, if any, by 
SCRIET EDIT requests are listed 


is separated fren its 
The 


Each reguest 
pore blanks. 


one cr 
below and are 





“Ye 
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€ SCRIPT 


3.1.13-7 SCRIPT 
RESPONSES: 


INPUT: 


This response is typed whenever the Script Input environment 
is entered. 


BULLS 


This response is typed whenever the Script Edit environment 
is entered. 


INVALID SCRIPT EDIT COMMAND 


The request just specified was either not a valid request word 
or did not contain a valid operand. Refer to the description 
of the individual request for its proper format. 


LOAD PAPER; HIT RETURN 


C This response is given whenever the SCRIPT PRINT command is 
issued without specifying the NOWAIT option. The carriage 
return must be hit in order for SCRIPT PRINT processing to 
continue. The paper should be adjusted as described above. 


ERROR MESSAGES: 


E(00001) GORREGT FORM IS: "SCRIPT" "EDIT" FILENAME, 
No filename was specified with ene SCRIPT EDIT command. No 
action was taken, 


E(00002) DISK ERROR, 
An I/O error occurred. If the file existed before the command 
was issued, it has not been changed by any editing requests. 
See Note d. 


E( 00004) INCORRECT PARAMETER LIST 
An invalid parameter has been specified for a SCRIPT PRINT 
control word, or a required parameter has been omitted. The 
SCRIPT PRINT command has been terminated. 


E(Q0008) FILE xxxxxxxx NOT FOUND. 


cescrited on the indicated pages: 
Request 


BCTICK ' 
CLANGE 
DELETE 
FILE 
IKEUT 
INSERT 
_KEEE 
LCCATE 
NEXT 
PRINT 
CULT 
REEJACE 
SEEK 
TOP 


Meer 


Page Ref. 


3.1. 43-8 
3. 1. 13-9 


3924-13-11 


3.1. 13-12 
3.74. 13-14 
3.1. 13-15 
321.13-16 
3.14.13-17 
3.1, 13-18 
3.4. 13-19 
3.1.13-20 
32.1. 13~22 
3. 4. 13-23 


3.1,13-9 


/y 


The SCKIET PRINT Contre] werds are issued as input lines toa 
file keing created in the Script Input Environment. These uords 
bill later be interpreted by the SCRIPT PRINT connand to gcvern 
format centrol as the file is being printed out. 


The SCHIFT PRINT contrcl words are listed below and are descrited 
con the indicated pages: 


Centrol: Word Feaning Page Ref. 

wAE Append 
BN Botton Margin 
eER : Break 
«CE _ Center 
eCk Compent 
CO Concatenate Ncde 
CP Conditional Page 
«DS Tcukle Space Node 

2 «FI Forcrat (cld fern) 
FO Fornat cde 
oHE Heading 
oHM Heading Hargin 
IK Inbed 
«IN Indent ; 
200 Justification NODE 
«LL Line Length 
oh No Concatenate Mode 

aNd Ko Justification MNcde 

OF cffset 
oPA Page Eject 
o EL Eage Length 
«PN Fage Nunbering Mode 
RL Bead Frow Térsinal 
SP Space Lines 
25S Single Space Node 
-TB Tab Settings 
TH - Top Kargin 
UN Undent . 
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SCRIPT PRINT control words: Uhe 
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ate 05/01/69 . , SCRIPT ti er 
SCRIPT HR 31 13-11 y Be 7 
EGITOK Reguest , as M3 CHANGE Request e 
Eurpose: Purpose: 
EOIION prints the last line cf the File being edited, positions CHANGE replaces a specified string of information in the current 
the geinter after this line,and enters the Script Input line with ancther specified string of information. 
environrent. . | 
Formats 
¥orpats 
1 1 ! ‘ 
f BOTTOM ! j CHANGE J fstringl - string2/ I 
| B ‘ 1 c ! 
- 7 . 
Usage:  t oar / is any unigue deliniting character 
: . that does not aprear in strinci or 
This reguest may he issued whenever the keytoard is unlccked in string2. 
the Scrirt Edit environnent. It is particularly useful when a 
Jarge SCKIPT file is teing entered in shert sessions. BOTTOH A 
Frints the last line cf the file to renind the user where he lcft string! is the grcur cf characters to be 
cff£, positions the painter after this line, and enters the Script ag replaced. If stringi is not specified 
Input envircneent te allcu lines to be added to the end of the String2 will Le placed at the 
file, beginning cf the current line. 
Responses: | . etring2 is the group cf characters which will 
XXXe0 0 a XUX replace or precede string1. If string2 
IRBOUTs: ° is not specified, string1 will be 
This is the normal response ta the BOTICN request where “xxx... deleted frea the current line. - 
xxx" is the last line cf the file being edited and the pointer is 
Fcsiticned after the last line of the file Frior to transferring 
centro] tc Script Input. Usage: 
NG CURRENT LINE. ‘ , When the CHANGE reguest is issued, the current line will be 
INEUG: ; gcanned for a match on the characters specified as stringi. Ifa 
This message will be given if a BOTTOM request is issued when the . ratch is found, the characters in string? will be replaced by the 
Fointer is fositioned after the last line of the file (i.e., as : Characters in string2. If ne natch is feund, the current line 
the next treguest after the message “EOF REACHED.“ has been will rerain unchanged. The strings dc not have to be the sane 
typed.) The pointer will net be moved, and control will transfer length; the current line will te expanded or compressed as 
tc the Scrirt Input envircnonent. reguired. 


Exarple: If string1 is not specified, the -contents of string2 vill he 
a 


. b , : eéppended to tha beginning cf the current line (see Example C). If 
‘This is the last line. gtringz is not specified, string! will ke deleted fron the 


INPUT: current line {see Exanple d). 
The last line of the file being edited, "This is the last line." : 
is _tyrad out and contro] is transferred to the Script Input 
envircnsent. Any lines entered inte Script Input will be 
appended insediately after this last line. 

SI 
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les 


otess 


a- No verificaticn is provided when a line is changed. To 
€xamine the changed line, issue the PRINT request. 


kb. Cnly the first occurrence of string! in the current line vill 
ke changed; nce global change is previded by SCRIPT EDIT. 


Responses: 





“TRUNCATED 
The reguested change has extended the current line tec more than 
1Z2C characters and the line has been truncated. 


NO CHANGE. 
Ke- eccurrence of stringl was found ir the current line. The 
Fointer is net ecved and the line xenains unchanged. 


Exarples: | 
ae 
cf shces end ships and sealing wax 
c sen/sanys 
of shoes and ships and sealing wax 7 


this change reguest uill cause the first occurrence of "en" in 
the current line te be changed tc "ant, 


tL. G ?ocs?ares? 


; of shares and ships and sealing wax 
the first eccurrence of “ocs" in the current line will be changed 
tc "ares" and the line will be expanded accordingly. 


Ce ¢ 22tc speak> 
BP 
tc speak of shares and ships and sealing wax 


The string "to speak" will te appended to the heginning of the 
current line. 


d. ce ssealingyy 
E 
to speak cf shares and ships and sax 
The string "sealing" will te deleted free the current line. 


; . 05/01/69 
peliee YY 3.1.13-14 
¥/ 
DELETE Reguest : ; CPE | 


Purpose: 


LELETE erases a specified nureber of lines fren the file and 
positicns the pointer at the lccatjon af the last deleted line. 


Format: 

i 

} DELETE 1 n 1 

1 oD H | 

e ry ; 
n specifies the nunker of lines te 
be erased. If caitted, 1 is assuned. 

Us 298: 


“Starting with the current line, the specified nunber of lines is 
deleted fron the file. If no nunber is specified, only the 
current line is deleted. If the DBLEYE reguest is issued when 
the pointer is fositioned at the null. line before the beginning 
cf the file, this null Jine will be ircluded in the count of 
lines deleted, but a null line will renain at the top of the 


Resronses: 


EGP KEACHED. 
The end cf£ file was reached hbefcre deleting the specified number 
cf lines. The fpeinter will be at a fpesiticn inrediately 
following the last line not deleted. 


Examples: 


a. DELETE 5 


Five lines cf the file are erased, beginning with the current 
line. 
Ke D 


The current line is deleted. The pointer will renain pesitioned 
at the point cf deleticn. 
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aeeaht /49 g 3.1.13-15 


' FILE Request 


Furrose: ‘ 


The FILE reguest stores the current copy of the file on disk, and 
exits tc the CMS Consand envircnzent. 


ed 


filenase specifies the nase tc be 
assigned to the created 
« file. If this operand is 
omitted, the filenane specified 
when the SCRIEBY Connand sas 
issued will be used. 


Usage: 


FILE is issued to save a new or edited copy of a file on the 
tser's permanent disk. It say te issued at any time in the 
Script Edit environment. The poesiticn cf the pointer is not 
considered, and the whole file is always stored. . 


Fxarple: 


ae FILE , 
dhe file currently being edited is stcred on the user's fernanen 
disk, replacing any previcusly existing ccrpy of the file. : 
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SCHIPT 3.1.13-1643 


INPUT Request . SES 


INEUT transfers the user from the Script Edit envircnnent tc the 
Script Input envircnsent. 


INPUT allcus the user tc add a line or lines to a file folloving 
the current line specified by. the f€cript Edit environnent 
pointer. The ney lines de net replace any already existing lines, 
but are inserted between what was the current line and the line 
that fernerly followed it. 


Note: 


If the pointer was at the top of the file, that is, at the blank i 
line receding the first line, lines entered after an INPUT i 
Frecede the former first line cf the file.. ; 
| 
| 
i 


Response: 


a-« INPUTS 
This response Signals entry to the Script Input environnent. 


Exarelps: 


ae ELIKT 1 

the £fclicwing fart nurberss: 

INEUT . 
The PRINT request types the current line. All lines entered 
after the response issued by the INPUT request will be inserted 
in the file fcllowing the line “the fellewing fart numkers:", 
until a null line is typed to return to the Script Edit 
envitcnment. 
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INSERT Request 149 


Furpose: 


INSERT allows a single ine of input to be added ta the file 


without transferring te the Script Input environnent. 


Fornat: 
i i 
! INSERT i line { 
| I. i 1 
line is the exact input line te be 
inserted into the file. 
Usage: ‘ 


This ‘request inserts the specified line into the file vithout 
entering the Input environnent. The liege is entered fcllcwing 
the line at which the pointer is currently positioned and the 
fointer is advanced to the.inserted line. the line is separated 
fron the INSERT request by cnly one blank; all other blanks are 
censidered part of the input line. 


Note: 


a. If the INSERT request is issued without an operand, it is 


interpreted as the INEUT request and the Script Input environment 
vill ke entered, 


Exarpile: 


ae I INPUT Line tc ke added to file. : 

The line "INPUT Line to te added to file." weuld be inserted 
after tke lire at which the pointer is currently positioned. The 
keyboard would then Fe unlecked to accept another SCRIPT EDIT 


request, and the pointer uculd be positioned at the input line 
just entered, , 


3.1,13-1709" —-KEEF Bequest —— ~: pie 


_ 
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in 


PULpose s 
KEEFE creates a new file on disk consisting of all paterial fren 
the beginning cf the file heing edited to the line above that at 
which the peinter is currently posjtioned. 


filename specifies the filenane tc be 
assigned to the new file. 


Usage: 


This request allows users tc create disk files which consist of 
‘pertions of existing SCRIE?T files. Bhen the KEEP reguest is 
issued, the contents cf the current file fron the first line to 
the line preceding the cne where the peinterc is positioned vill 
te saved cn the usects pereanent disk. This file will have the 
filenare specified in the KEEF request, a filetype cf SCHIPT and 
@ filerode cf Pis This saved portion sill then be crased fron 
the current file and the line at which the pointer is positicned 
Will be -conse the first line of the file Leing edited. 


Responses: 


OLD FILE NOT FOUNL 
The KEEP reguest was specified with the pointer positioned at the 
first line of the file. Ne "old file" exists akove the pointer, 
and therefore ne acticn is taken. 


NEW FILE ALREADY EXISTS 
the filenane specified in the KEEP reguest has lalready been 


assigned to a SCRIPT file. Yo file has heen created by the KEEP 
reguest. 


INVALID SCRIPT EDIT CCHMAND ; : 
ho filenane was specified with the KEEE request. A filenare nust 
be specified and must. he separated fron the request by at least 
cne blank. 


: . 
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3.1.13-19 
3.1,13-20 
Exat de : th, ahr tA 
fst 44 LCCATE Bequest UGE [2 
ae KEEF CHAPT3 Soueuees 


A file will ke created cn disk with: i ifi 
: ; an identifier of CHAPT3 
ee will ccntain all lires fren the beginning of 
ea pe to the line above that where the peinter is LOCATE searches the SCKIET file fcr the first cccurrence cf the 
pert nete ot seen will be eraeed fron the file and the specified string. 
C . is positioned will beccne i 
ef the file keing edited. - Rooters por | 


Format: 
1 ! j 
i LOCATE 1 /stcing,y ] 
{ L i 
/ is any unique delinziting character 


that is nct ccentained in the string. 


‘string is any grcup of Characters to be 
searched fcr in the file. 


Usage: 


LCCATE scans each line cf the file fcr an exact patch of the 
character string specified between the two deliniters. The scan 
Ecgins cn the line imnediately following that at which the 

: pointer is currently pesiticned and continues until the string is 
fcvnd or until the end cf file is reeched. When a watch is 
found, the keyboard sill be unlecked and the pointer will he 
pesiticned at the line in which tke first cccurrence of a natch 
was found. 


heeponses: 


— FF he 


ECE &EACHEC. : 
this gsessage is typed shenever the end-cf-file is reached hefore 
a match of the string is Ecund. . 


Exanple: | . 


ae lecate /ahcdy 

the file will be scanned, starting with the line immediately 
following that at which the Ecinter is currently positicned, for 
an occurrence of the characters "abcd". If a natch is feund, the 
keyboard will be unlocked with the pointer positioned at the 
satching line. , 
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NEXT heguest BOS pore 3 3.1.13-< 
hegues HW 153 PRINT Request ed 
7 ier 
Eurrosss: eee: 


NEXT meves the current line peinter forvard } i 
lines in the file. . a specified number of ; The ERINT request types the specified nuxker. of lines, beginning 


with the current line. 


Formats 
Format: 
i OO eel 
} NEXT | n | 1 ! 
i k I | ERINT i n j 
a | be 1 | 
e a 
Usage: . va ’ 
° n specifies the nusber of dines to type. 
If omitted, 1 is assumed. 
.Tthe current line fointer is advanced the specified nunber cf 
lines, cxrote the next line if no nunber is specified. Tf Usaqet 


end~cf-file is reached, the pcinter renains pesitioned after the 
last line of the file. a 


The PRINT nequest is used to exanine the contents of lines in the 

file while in the Script Edit envircnment. The current lire is 

always the first line typed. The yointer is advanced to the last 

; ° line typed. If only cne line is specified, the Feinter does. not 
FCE BEACHED.« : wove. If end-cf-f£ile is reached, the pcinter vill be positioned 


jhe end-cf-tile was reached hefore advancing the pointer n lines. after the last line of the file. 


AESECNSES: 


Exeuples: Responses: 


ae NEXT 15 NO CURRENT LINE 


-oipter is ; ; this message indicates that the pointer is fositicned (1) before 
The pointer is advanced 15 lines, counting the nent line as cne, the first lire cf the file (2) after the last line of the file, 
cr (3) at a line which has just teen deleted. 
be. on 
The pointer is advanced tc the next line. : 

ECF BREACHED. 
This nessage is typed whenever the end cf file is reached befcre 
rn Jines have teen printed. The feinter will be positioned after 
the last line of the file. 


Exanples: 


ae PHINE 3 . : 
Ihrec lines are typed out at the terminal, beginning with the 
current line. The pointer is advanced tio lines. 


05/01/69 
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SCRIPT ae SS, 

tk. P 1,432-93 QUIT feguest GE) gf 

The ~ . *, ara HSS -FAAL ERS / s 
current line is tyrsed, and the pointer is nct soved aCe 


the GUIT request retuxns the user to the CNS Conmand environment, 
hithcut saving the current cory of the file being edited cn disk. 


forrat: 
] l 
i QUIT | 
j C i 
° ‘ 
, Ysagg: 
‘ This request provides an exit fren the Script Edit envircrrent 


without saving the ccpy cf the file being edited. If the file 
existed cn disk previously, it still exists without any of the 
changes fade by the current SCRIPT EDIT connand. If the file was 
created by the current concand, it is ¢rased. 


Exanple: 


as. °- Gust 

‘The current copy of the file is erased. Control is returned to 
the CMS Cconmand envircnsent. If this vas a previously existing 
file, it remains unchanged cn the userts permanent disk. 
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3 apenrs | 3.1,13-26 
REPLACE fequest 1 Uy 
¥ ge 
[3 i (an © 
. ‘a Examples: S858 
Eurrose: Aa eee 
The KEFIACE request erases the current line of a file, and a. REPLACE even though the hippogrif was_ 
replaces it with a specified file. The current line is exased and the line “even though the 
, ron hipgegrif was" is inserted in its place. 
Gimat: , : 
Format: a L. r In view of these results, it 
The current line is deleted, and the ling "In view cf these 
Se fe et te, cata ae ee, Be . results, it" is inserted in its place. Kote that five of the six 
' \ ‘ tlanks betveen "rc" and "In" are retained as part cf the line. 
| BEPLACE I newline t The cther Flank serves as a deliniter tetveen the request word 
- 4 and the neuline. 
‘ $ Cc. ro 
newline is the line which replaces the current The current Jine will te erased and the Script Input environnent 
line. This line starts in the first till be entered to allow any number cof lines to be inserted in 
pesiticn fclloting the first blank its place. . 
: after the request. If no cperand is 
specified with the HEPLACE request, 
the current line will be deleted and 
the Script Input environment will be 
entered. 
Usage: 


the’ first klank follcwing the reguest serves as a delimiter. 

Additicnal blanks are considered part cf the new line. The new ; 

dine pust ccntcrm te the requirements of the Script Input i 
envirournent, except that the request werds and the first blank 

are net ccunted in deternining length. 


tae ee 


a. If ne operand is specified with tke REPLACE reguest, the 
current line will he deleted and the Script Input environment 
will te entered. This is especially convenient when it is 
necessary to replace cne line by more than cre line. 


Resrcnses: 


IKFEUT: é 
hie respense indicates that the Script Input envircnrent§ hag 
keen ertered. It will he qiven thenever the REPLACE request is 
issued without an operand. The keyhkcard will be unlecked to 
éllevw any nurber cf lines tc ke inserted in the file in place of 
the current line. ‘ 
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SCRIPT 4,1.13-27 
SEEK Fequest Oy 
yee 
Furgcse: 
The SEEK 


reguest advarces the current line pointer to the line 
these leading characters are specified ky the operand, cr tc 
end-cfi-file if ne matching line is found. 


_— eee 


{ SEEK { string | 
I s | ] 
string is-any nunter cf leading characters 
. : from the line tc which the pcinter 
is to’ he advanced. 
Usage: ° 


Starting with tbe Jine fcllcwing the current lina, the leading 
Characters of each line are ccupared te the specified string. the 
Cccupariscn is colunn-dependent; the character following the first 
Elank after the request werds will te ccspared te the first 
character of the line, and sc cn. Blanks are Significant, and 
bust be included. The first line whose leading characters ratch 
the specified characters beccses the current line. 


Responses? 


ae ECP REACHEL. 


ho watching line was fcund. The 


Fointer is positioned after the 
last line of the file. 


A ot 


Exarples:. 


=e ced 


a. SFEK west 
Eeginning with the line fcllcwing the current line, 
four characters cf each line are ccpfared to the 
"pest". The following line would kecone 
were ar the file below the cucrent line. 


the first 
Characters 
the current line, if it 


west of the Mcncnegahela. 
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3.1.13-28 
LR Ed 
{hese lines would be skipped: 
West of the MNecn. (Upper case “R"") 
west, young pan. (iirong coluuns) 
ai aay said ir ight characters 
i 2>guest would search fcr a line whose first eigh 
eae rie west", ‘The last line of the previous exauple would 


becone the current line, if it were in the file. 








ce emcee repens hae in nse hit nm ow Rc we 
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re $.1.13-29 SCRIPT 05/01/69 
tequest — KEG 3,1.12-30 
Faper Layout : MP [boots 


Many of the Script Frint centrol words affect paraneters cf the 
JOP places t : . 2 ; Fazer laycut. The diagram belew indicates certain of the 
cf ihe ae pointer at the blank line preceding the first line impertant paper layout parameters: PAGE LENGTH (PL), TOP MARGIN 
(TM), BOTTOM MARGIN (BM), HEALING MARGID (HE), LINE LENGTH (LL), 
and INCET (IN). 


Format: 
{ ! 
l IOP | 
] ! 
- : . e 4 . ¥. 
Usage: el cf Jeft-hand physical margin 
“ICE may te issued at ti , Me Veen Nepean ee I. RUA 
the fleet dine wt the Gil. At icve vechten ee L sheadeey: -eaGh ef af 
v ; . cWf recursive passes t 
rade threugh a file with a single SCRIPT ELIT aan ene : eerrewerer rm ememem en maven ae 
Note: wee MTT 
I | , | ! I 
7 I ! I ( 
the ee line that becomes the current line after a TOP request 
ea ag present in the Script Edit environment. If replaced or . } | I | j 
reted, another blank Tine is supplied. It allows additicns te | | TEXT: { | { PL 
be sade at the top of the file. i { j 
{ I { | I 
Exangless . 
! I od ! | 
ae TCP . { J I } | 
The current line peinter is noved 1 ' 1_—---——-—— | —-- | 
tirst line of the file. SEEN Ega ob al eens re tie | BH I 
: i I 
{ j } 
! i Vv 


a= a 


ee AA ee AO Le HD i A HE GN tl ae sae SO ee ee 


yin 4 i 
1<--~-| \ 
i 
| <eeennn nnn n n= | 
Li i 
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pcan et ye BCTTOL BKAKGIN Contre] Fd 
és he 
| EULECSS? 


Purpese: 


The ROITCK KAKGIN control werd specifies the nunber of lines tc 
te skipped at the bettcx cf cutput pages, overriding the standard 
value cf three. 


ihe APFENB control: word allews an additional SCRIPY file to be 
appended to the file just printed. 


st a ine a whee 


—-— ee eee 
-— See 


meee 


filenage specifics the nare of the SCRIPT 
: : file tc ke appended to tke file 
which ‘has just been printed. 


n specifies the nunber cf lines to ke 
skipped at the Ecttos of cutzput rages. 
If critted, 1 is assuned. 


Usage? ar 


fee 


when the .AEF Control word is enccuntered the current file will be 
closed, and the specified SCRIPY file will ke printed as a 
ccntinuaticn of the SCRIPT EBINT output fircm the previous file. 


This ccntrol overrides the standard hcttor bargin size cf three 
lines, ard need not be included in the file if that value is 
Satisfactcry. It may te included anywhere in the file, and the 
Best recent value set applies: cn any page. 


Netes: 
‘ Nete: 
a- The -AP centrel werd cnly allows files to be appended to the 
and of the current file, If it is desired to insert file The EOTTCK FALGIN ccntrol werd alse acts as a BREAK. 


ccntents inte the printout of the current file, use the <I 
ccentrol werd. : 


Xanples: 
Exanrles: 


ae BM 10 : 
Ten lines will be left blank at the bottor of the current page, 


- aA AES if pessitle, and on all subsequent pages. 


The ccntents of SCRIEIT file AEC will be typed imnediately 
fcllcwing the last line cf the current file which precedes the 
eAE request. . 








EREAK Certrel Jy 
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3.1,13-33 
Gus 
4S 


ULEOse: 


When CCKCATENATE is in effect, BREAK causes the previous line ta 
te typed witkcut filling in werds fron the next line. 


Format: 
! 1 
| aER | 
! ] 
Usage: . . 


: EREAK is used to prevent concatenaticn cf lines such as faragrarh 
feadings cr the last line cf, a paraqrarph. It causes the 
Ereceding line to be typed as a short line, if it is shorter than 
the current lire length. 


Nectes: 


ee. 


a. Many of the other ccntrcl words have the effect of a BREAK. 
Ne EREAK is necessary when cne cf these is present. : 


ke. A leading Flank or tab cn a line has the effect of a BREAK. 


Exanspinss 
Be ‘heading: 


‘Piret line of the paracraph . e . 
this part cf a file will be printed by SCRIPT PRINT as? 


heading: 
First line of the paragraph . . .« 


If the BREAK ccntrcl werd sere net incluéed, it would be typed: 


Heading: First line of the paragraygh . . . 


05/01/69 
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YF [th 


SCHIPT 


CENTER Control 
ULECEe? 


the line following the CHENIER centrol word -will, ke centered 
ketween the margins. 


— mee 


The line tc be centered is entered on the line following the- 
CENTER ccntrol word. It starts at the left margin, and leading 
cr trailing tlanks will be ccnsidered part of its length. 


Netes: 
a. The CENTER control acts as a BEEAK. 


k. If the line to te centered exceeds the current line length 
value, it is truncated, 


Exanele: 


ae CE 
Cther Methods 


When this line of the file is typed, the characters "Other 
Kethods" will] ke centered tetween the margins. 





. SCBIFT. 


CCMMENT Centred 


Evrpose: 


The CCHMENT control werd causes the réenainder cf 
ignored allowing ccnnente to be stored within the 


05/01/69 


3.1,13-35 ESS? os 

4, 5 05/91/6y 
Hie , ooeees 3.1.13-36 
hf CONCATENATE Centred aS 4 


the line to be 

SORTED: SARS: CONCATENATE cancels a previous KO COLCATENATE ccntrol vord, 
Causing output lines tc te formed by ccncatenating input lines 
and truncating at the nearest word to the specified line length. 


Fertat: 
“2-27 er eer ere wee Feorvat: 
{ i { 
| of ¥ { consents ] 
i i r ene | er ' 
] CO | 
? | | 
Usace: i Ae a 
The -CM ccntrcl word allcuws conrents tc be stored in the SCRIPT Usage: 
cee fcr ae reference. These consents can ke seen when 
‘ editing the file in SCRIPT EDIT or inti i . 3 
UXNFCRBNAT node. Eesah ind) Sie bide: © anges The CONCATENATE contrcl specifies that cutput lines are to he 
formed by shifting werds tc or fron tke noxt input line. The 
The consents may alsc ke used te store unique identifications _ resulting line will be as clese to the specified line length as 
that can te useful wher attenppting to lccate a specific region of ee ee oan ee ie tga ae creed acae as 


the file during editing. 


Ie 
ify) 


Bples 


ae _ 0 CH Kenenter to change the date. 
He line ahcve will be seen when exanining a unfcruatted listing 
ct aie SCRKIET file and resind the user te update the date used in 

e text. 





cperation fcr the SCRIET EFRINT connard, CONCATENATE is only 
included te cancel a previces KO CCRHCATEMATE control word. 


Kotes: 
a. This control acts as a ERFAK. 
Example: 


ae .cO 
Cutput fron this point on in the file will be forped to approach 
the right margin withcut exceeding it. 


. SCRIPT _ eae ae 


he 


CCNDITICNIL EAGE Control bf, 


The CCKDITICNAL FAGE centxrcl word causes a page eject to cccur if 
less than the specified nusher of lines renain on the current 
age. 


n Specifies the nunber cf lines 
that must remain on the current 
fage fer additicnal lines tc he 
pointed cn it. 


Usage: 


fhe .CP ccntro) word will cause a page eject to accur if "n" 
lines de net renain on the current page. This request is 
especially meaningful (1) befcre an «SP control word to guarantee 
that sufficient space remains cn the current page for the number 
cf sfaces requested aleng with any titlcs, and (2) preceeding a 
section heading tc elininate the possibility of a heading 
cccurring as the last line cf a page. 


ote: 


a. If nc cperand ig specified with .CP request, the request will 
ke igncred. ; 


ed 


ae ' aCEB 10 : 

If less than 10 lines resain on the current page, an eject will 
te issued before printcut ccntinues. If 10 cr mere lines renain, 
Erintout will ccrtrinve cn the current page. 


bf 


: 05/01/69 
SCEIET -8,7,13-38 

, EF" 
CCUFLE SEACE Centrol Be? 
Sb 


urrese: 


The LOVELE SPACE centrol werd causes a line to be skipped ktetween 
each line cf typed output. 


-— —=— —_ — ww 


-BOUBLE SEACE may be included anywhere in the file to force doutle 
spaced autput. 


ie - 


Otes 
This centrol word bas the effect cf a BREAK. 
xenyle: 


ae «IS 
Elank Jines will he inserted between cutput lines belcw this 
yoint in the file. 


SCRIPT 05/01/69 SCRIPT 


3.1..13-39 05/61/69 
FCRHKAT Control Et Exanrle: 3.1.19-40 
“, : LOGe 
, | a JEL 
Furpese: - aes BFC 


Cutput fren this peint cn in the file will be padded te preduce 


an even right nargin cn the cutput page. 
the FORMAT centrol word cancels a previous NC FORMAT control werd ’ : P ded 


{cx HC CCNCATENATE andyvor OQ JUSTIFY control werd), causing 
concatenation and right justification of output lines to resuue. 


Fortra : 
j | 
] ofFiI ] 
t 
Aas nd ae : : 
or : 
J | 
{ .FC f 
| l 
Usage: - 


the FCEMAT centrol werd is a short-hand way tc specify the tro 

contro] words: CONCATENATE and JUSTIFY. This centrol specifies . « 
that lines are to he forced by shifting words to or fron the next ‘ 

lines (ccncatenate) and then padded with extra Llanks to produce 

an even right margin {justify). This is the nornal mode of 

cperation for the SCBIE1T EBINT command, FORNAT is only included 

to cancel a previous KC FGOBHAT centrol scrd. 


Notes: 
a... This ccntrel acts as a EBEAK. 


be. If a line without any blanks exceeds the current line length, 
it is truncated. 


c.* The eFI form of the ccntrol word is provided fcr 
cenpatibility with cld SCBIE1 file and should not ke used in new 
files. 








o a 


SCRIPT exon es 
HEADING Centre) 8113-41 
centre My 
be 
Pee 
Purrcse: f3 


a . . . 
The EEADING ccntrol ucrd specifies a heading line to be typed at 
the tog cf subseguent output pages. 


eee eee 


line specifies the heading to he 
. printed at the tcp cf 
subsequent pages. 


All ‘of the Jlaine fcllowing the first blank after the HEADING 
ccntrol word is printed at the tcp cf pages started after the 
centro] wucrd is encountered. Nec heading is typed on the first 
Fage cf an cutput file. The heading is typed at the left rnargin. 
Its length oust be at least 10 less than the output line length, 
to allcu for a page nubber at the right margin. Leading blanks 
fay be used te center the heading. The heading is typed in the 
line specified by the heading rargin and top margin control 
sords. Additional .HE centre] words vay be included at any point 
in the file to change the heading cn subsequent pages, 


Note: 


If a new heading is to te placed on a page ftcrced with the PAGE 
centro] word, the HEALING ccntrol nust precede the PAGE ccntrol. 


sxaeples 


ae .. wo BE CAMBRIDGE FGNITCE SYSTEM 

The characters "CAMBRIDGE UGNITCR S¥STEK" will be typed at the 
left in the second-last line cf the top margin cnall_ rages 
started after this point in the file: 


CAMBRIDGE MCHITOR SYSTER PAGE 7 


SCRIPT 05/01/69 
3.1,13-42 


3 LFpaf 
be whe CHS Af 


The leading blanks are considered part of the heading, sc the 
characters "CNS" will ke centered in the heading line: 


CMS EAGE 8 . 





SCRIPT — ~ 


HEALING MARGIN Control 05/01/69 
3.1.13-43 
HERS 
“Purpose: ae 
is 


The KEALING MARGIN control werd specifies the nunber of lines to 
ke skipped betweer the heading and the first line of text 
excluding ferced spaced (TOF HARGIN), overriding the standard 
value cf cne. ; 


Format: 
] I “4 
{1 HE | a 1 
| S j | « 
D specifies the nuaber cf lines tc ke 
skipped after the heading line. 
Usage: 


The heading line will ke placed a specified nurber of lines above 
the top rargine If noc HEALING NARGIK control word is included in 
the file, the default value is one. 


The HEADING MARGIN specified must always ke less than the current 
TCE BAERGIN. : 


ctes: 
This ccntrol word acts as a EREAK. 


xanple: 


{ent 


ae oEN 3 
Three lines will he left tetween the heading line and the first 
line of text. If default tcp margin cf §S is in effect, the 
beading will cccur one line fros the top cf paper followed by 
three nore blank lines {the heading margin) and then the text. 

+ 


bet 1 
the standard heading margin cf one is set. 


SCRIPT 
05/01/59 
3.1.139-44 


OB fol 


IMEEL Centrel 
Purpose: 


the IMBEEC centrol werd is used to insert the ccntents of a 
specified file intc the grintcut of another SCRIPT file. 


Fornat: 


filename specifies the file to he 
currently fcrmatted into 
the printcut. A £iletype 
of SCRIET is assuned. 


Usace: 


fhe .IM and .AP control swcrds perforn sinilar functicns, Eut .Ih 
allcus tke ccrtents c£ a second file to be inserted iato the 
Frintcut cf an existing file rather thar appended to the end of 
it. Inwbtedded files way specify additional] imbedding to a depth of 
seven levels. Inhedding cay te used tc insert standard sets of 
centrol weeds at desired spets in a’ file as well as many other 
uses. 


Exaryple: 


BS oIt CHAPY 

The contents of the SCRIPT file uhose filename is CHAP4 will ke 
inserted in the printcut cf the current SCRIPT file,. when the end 
cf the CEAP4 file is reached, printcut cf the current file vill 


resure. 

Error NesSagEs : 
E(cccCz4) NCRE THAN EIGK1 ACTIVE FILES ~ BEDUCE NESTING. 
Bore than seven files have EFeen irbedded in the SCRIFT file being 
printed. Only eight files nay ke open in CHS at cnce. All open 
files will te clesed, and the SCRIEI ERINT command will Ee 
terminated. 





INDEN 


Eu 


c 


SCRIPT 





05/01/69 
3.12.13-45 
% Centxrol ; 
MEEPS 
ae, 
rposes fe 


fhe INBENT ccntrol serd allows the left, side of the SCRIPT 
Exrintcut to be indented. 


Rat: 

1 ! ! 
{ '.1N | n { 
| 1 { 

D specifies the nunker of spaces te be 
indented. If cnitted,indentaticn will 
revert to the original margin. 

Bges 


The «IN centrcl vord causes SCHTPT prirtout to he idented "n" 
spaces fren the current left margin setting. This indentation 
Lesainsgs in effect fer all - following lines, including new 
Faragraphs and pages, until another .IN control werd is 
encountered. ".IN 0" will cancel the indentation, . and printout 
will ccntinue at the criginal left nargin setting. 


tes: 


a. The .IN request acts as a BREAK. 


Ek. The .IN reguest will reset the effective left nargin, causing 
any .OF setting to be cleared. The .OF request nay be used alone 
cr in cenjurcticn with .Ih. When the latter is the case, .IN 
settings will take precedence. 


Be ‘eIN 5 ; 

All lines frinted after this request will be idented 5 spaces 
fren the current left margin setting. This indentaticn will 
continue until ancther «IN ccntrel werd is encountered. 


, i, - 


PY AEB 
OG oes 
rE In 0 3.1.13-46 
The effect of any current indentaticn will be canceled and 

printout will continue at the criginal left margin sctting. 


SCRIPT 





SCRIPT 4 i 


é ai 05/01/69 SCREPS 95/01/69 
JUSTIFY Centrol $.1.13-47 . 
yo LINE LENGTH Centro] : cee 48 
ACen, eee 
. : Ae : : : 
Purrose: | | ih / & 
ENULE OSes 
The JUSTIFY control word cancels a previcus NO JUSTIFY control ; ora 
word (cr part cf a NC FORMAT contrel word), causing right The LIkE LENGTH central wcrd specifies a line length that is to 
justificaticn of output dines to resune. : GVELLTIGE the standard live length of 60 characters. 
Format: Rt Fornat: 
j | | i | 
» .J0 | J «LL ia | 
i a epee 
n epecifies cutput line length nct 
Usaces ; ee greater than 120 characters. 
this centrol vord specifies that lines are to be justified by sags: 
padding with extra tlanks. If concatenate node is in effect, the 
concatenaticn process cccurs before justification. This is the es 
nermal nede cf cperaticn for the SCRIPT EFFINT connand, JUSTIFY is Tke LIFE LENGIH centrcl sets the length for output lines until 
cnly inoluded to cance) a fpeevious HO JUSTIFY control word or the the next LIKE LENGTH centre) werd is encountered. If no LINE , 
KO JUSTIFY pact of a SC FCBNAT ccntrcl verd. LENGTH ccntiol is included in a file, the standard line length of 
6C characters is used. 
Rotes: 7 : 
“ In the JUSTIFY/NC CCNCITEKATE erode, lines shorter than line 
length are justified tc length by blank padding. 
a. This control acts as a EBEAK. : 
t. If a line exceeds the current line length and concatenate In the CONCATENATE made, lines longer than line length are 
scde igs net in effect, the line is printed as is. sfilled intc the fellcwing line. Lines shorter get words fron 
; Erevious cr follcwing lines te approach line length. : 
c. This ccntrol word is seldom used without concatenate node, ; 
therefcre, FCRMAT should be used to enter justify and concatenate 
. cde. Note: 
@e aq é 
Exanyle: ° this ccntrol acts as a AREAR. 
a. “0 Exangle: 


Output fren this gcint on in the file will be padded tc produce 

an.even right margin on the cutput page as long as the inrut 

jines dc not exceed the line Jength. ae oil 56 : 
Succeeding linas will be ne secre than 5C¢ characters jn length. 


e 


e 








05/01/69 
Ree e 361,.13-49 
KC CONCATENATE Control AME 


; _ 57 
Purecse: 


Tbe XO CONCATENATE coentrcl stops vords fron shifting -to or fron 
the next line. - 


= 


Usaqe3 


The BO CONCATENATE ccntrol werd stops serds fron shifting to and 
from the next line. There is a one-to-cre correspondence ketveen 
the words on the input lines and output lines. It is useful for 


sections cf files ccntaining tabvlar infcrnation or other special 
fornats. .. 


Notes: 


a. this ccntrol acts as a BBEAK. 
Example: 


a. » a NC 
Concatenaticn will be ccmpleted for the preceding line cr lines, 


but fcellcwing lines will ke typed withcut words being moved to 
ard frcn lines. 


NC 


SCRIPT 


(05/01/69 

FORMAT Centrel ' 3.1.13-50 
3 EES 

Purpose: . (hele 


dhe NO FORNAT control stops the CONCATENATE and -JUSTIFY node, 
causing lines te he typed juet as they appear in the file. 


Foruat: 
1 { 
} «NF ] 
| ‘t 
Usage: 


_The NC FCREAT control is a shert-hand way to specify the tyc 


centre] words: NO COBCATENATE and NO JUSTIFY. This stops line 
justificaticn and cancatenation until qa FORMAT, JUSTIFY, of 
CCNHCATENATE control werd is encountered. It is useful for 
sections of files containing tabular infcrnaticn or cther special 
fcrnmats,. 


fo wet ne es ae 


a. ‘this ccntrol acts as a BREAK. 


Exazyie: 


Be o NF 

Justification and concatenation will be conpleted for the 
Ereceding line or lines, hut follovirg lines will re typed 
exactly as they appear in the file. 


SCRIPT 05/01/69 A . SCRIPT 05/01/69 


“4s QUETIPY Control 3.1,13-51 3.1,13-52 
os oRErS MISE OFFSET Control]. LEO 
A eae 
7 ‘a Pie | . Sd 2 
Purgcss: Par 


‘The NO JUSTIFY centrcl stops padding lines to cause right 


justification of output lines The OFESET control word prevides a tecknigue for indenting all 


but the first line of a secticn. 


ormats 
eae Forpat: 
1 \ doa es eS as ie eet 
kJ | J i 
| { «OF | Dn j 
ao eee rite | t ! 
“ . . ‘ 
Saceé: 136 
.. = n specifies the nunber cf spaces to be 


indented after the next line is printed. 
Lf cmitted, indentation will revert tc 


The NO JUSTIFY control word stcps the blank padding of lines. If the original saigin setting 


concatenate scde is in effect, lines wil] be formed that approach 
the current line length but will not be forced to the exact 
length. The resulting lines resesble the output usually produced z 
ky a typist cre a WI/ST (Kagnetic Jape/Selectric Typeuriter). Usage: 


The .OF ccntrol word way be used to indent the left side cf the 
frintcut. It's effect dees net take place until after next line 
is printed, and the indentation will repain in effect until a 
treak cc until ancther .OF centrcl word is encountered. 


4 


otes: 


| 


a. This cantrel acts as a BREAK. 


The .OF ccntrcel way be used within a section which is also 


Xarple: . 
Exaxtle indented with the .1N control. Note that IN settings take 
precedence cver -OF, hctever, and any iN request will cause a 
a. ohd Erevicus offset to ke cleared. . 


Justification will be ccespleted fer the preceding line or lines, 
but fcllcwing lines will tke typed withcut additional blanks 


inserted to pad the line. If it is desired to start a new section with the sane cffsct as 


the previcus secticn; it is necessary to repeat the “.OF nt 
reguest. 


Notes? 


. ae This control acts as a BREAK. 


te. Two CEFSET centre] words sithcut an intervening text line is 
ccnSidered an error ccnditicn. 





P , are . 05/01/69 
SCLIPT 05/01/69 . © SCBIPT 3,1.13-54 
3.1.13-53 Me 
xanples: Ps PAGE Ccntrol : i 
| AES 
a. OF 1C Furpose: 


the line inmediately follcwing the .OF ccntrel word will be 
printed at the current left sargin. Al} lines thereafter (until 


the next break or .OF request) will be indented 10 spaces fron EAGE causes the cutput fcrs te be advanced to the next page. 
the current rargin setting. 7 


: : Fornat; 
b. «CF , 
The effect of any previcus .CF reguest sill be canceled, and all 
Frintcut after the next line will coutinue at the current left er We IRE RD AES PSR = 
marcin setting. { { 


~~ mm 


pn £pecifies the page nuuber of the 
next page. if "n" is not specified, 
sequential page nusbering is assumed. 


Usage; 


‘fhenever a EAGE control werd is enccuntered, the rest cf the 
current page is skipped. he paper is advanced to the next pege, 
the heading and page numkter are typed, and cutfut resumes vith 
the line fcollcwing the PAGE centrol sword. If STOP was specified 
with the SCRIFT ERINT copmand, a carriage return cust be entered 
when the kcttcm of the page is reached. 


Rotes: 
a. This centrol acts as a BBEAK. 


kt. IF the heading, line length, cr cther format paraneters are 
-to be different on the new fage, the agpropriate ccntrel sords 
rust appear before the PAGE ccntrol sord. 


‘ 
e 


Exanpie: 


ae oEA * 

The rest cf the current fage will be skipped. The heading and 
rage nugkec will be typed in the top margin of the next page, and 
cutput bill resume. 


‘ 05/01/69 


SCRIPT Secs ‘ a lyre 
rt. PAS fb 1E 7 . Sede t= RP 
regardless of the nunter of the current page, the rest of that PAGE LENGTH Ccntrol lil 3 


fage will ke skipped, the heading and page nuzber 5 will he tyfed 
in the tcp margin of the next page, and cutput vill resune. 


SIS 


Furpose: 


The FAGB LENGTH Control werd specifies the length cf output pages 
in linese The value epecified overrides the standard page length 
cf 66 lines. 


Formats 

} 1 | 
| «EFL H n 7 

. 1 I J 
eis sab DoS Aad’. ecg hey. tt ei : 

: n epecifies the length of output 
fageés in lines. 
Usage: 


The PAGR LENGTH contra] tcrd allows varying paper sizes to be 
used fcr cutput. If no FACE LENGTH control] word is included in a 
tile, 66 is the default valve. This is the correct size of 
standard typevriter paper fcr terninals typing eight lines fer 
inch. Page length nay te changed anywheré in a file, with the 
change effective on the first page started after the ccntrol word 
is encountered. ‘ 


Xotes: 


This ccntrol sord acts as a EREAK. 


ae oPL 51 


age length is set te 51 lines. This is the correct size for 
tersinal typing six lines per inch. : 








; : SCRIET ' ; SCRIPT 05/01/69 
: 05/01/69 : 3.1.13-58 
PAGE AUFEER Centro SS Na be EAGE CRFNC : MES 
: (EEE Nc gage nunbers will appear on SCRIPT PRINT output and the 5 
Puipese: SSG internal page count will remain at its current setting without fe 


teing fucther incresented. 


fhe FAGE NUMBER control] werd alleys the user to control both ‘ PAGE ON 
en ag Oe eg eee fe ene cee are ret en Paige eee kage nusbering on SCRIET EBINT output will resume using the 
current internal page ccunt, and this ccunt will be increnented 
Forgats: for each page printed. . ‘ 


! ! ] 
! ! OFF { ‘ 
H PN i OFFNG 1 
] ! ON 1 
| : I { 2 
ee ee ee a es a 
CFF Suppresses external page nunbering, : a 


although internal page nustering : 
will cantinue. : 


CPFNO Suppresses Ecth external and internal 
page nurbering. 


CN causes external page numbering.tc he 
resuncd. 


Usage: ; . . : 


«PN is used to contrcl the gage nunterirg feature of the systen. 
if the OFF cperand is specified, page nunbering will discontinued 
cn the frintout, although the page nustkers vill ccntinvue to be 
incremented internally. The OFFKG operand will also discontinue 
fage numkering on the printcut and will cause the page nusbers 
net tc ke incremented internally. When the ON operand is 


specified, page nunbering will resume fren the last internal page ' ‘ 
nuprer. 


Exarples 


ae page off 
ne further page nusbers vill appeac cn SCRIPT PRINT output, 


althouch the internal page ccunt will ccntinue to be increnented 
for each page printed. 





05/01/69 


| SCHIPT 3.1.18-59 
REAL Centrol MEE 
‘ 1 /t 
Furpose: 
dhe READ Ccntrcol word allows the user to enter a line from the 






allcw cne line to be typed at the terninal. 


terminal during SCRIPT PRINT output. 


0 specifies the nusber cf lines tc be 
read at the terninal. “If onitted, 
1 ois assuned. 


Sage: 
then the .RE control werd is encountered during SCRIPT PRINT 
cutput tc the terminal, it will act as a EREAK, spin the type 


head several tines, 
The line entered is 
cccucs cn it. This 
fors letters, etc. 


and unlock the keykcard for a line cf input. 
igncred by the pregramn and no formatting 
facility is useful for adding headings to 


a 


As rany .RD*se may be used as desired; each vill 


eeparate line accepted at the terminal. 


result in a 


gntro] werd acts as a BREAK. 
Ae : 
: - 


ae oRE a ° 
When this ccntrcl word is enccuntered during SCRIPT PRINT output, 
the type head will rctate and the keybcard will be unlocked to 


Vey 





SCRIPT. 


SFACE Ccaotrcl 
Purpose: 


The SEACE ccntrol word generates 
lines tetore the next tyred line. 


a specified 


n specifies the nuater of blank lines 
to be inserted in the output. 2if 
cnitted,-1 is assumed. 


Usage: 


05/01/09 
3.1,13-60 


WH 
Off 


nupber of blank 


The. SPACE centrol yerd say be used anywhere in the file to 
generate blank lines. If fage end is reached during a SPACE 
cperation, rekaining blank lines are inserted after the heading 
cn the fcllowing page. If LTOUBLE SPACE is in effect, twice as 
nany blark lines are generated as specified. 

Note: 
This ccntrol acts as a BREAK. 

Exageles: 
ae - «SE 3 7 - : 
Three klank lines are inserted in the output: before the next 


typed line. 


ke «SE 


A single blank line is inserted in the cutrput. 








a oO a 





. 05/01/69 os 
SCBEIPT 2 > SCRIPT 
3.1.13-61 be., 05/01/6S 
SINGLE SPACE Ccntrol ERS TAE SE17ING Centrol . $.1.13-62 
. ia . : ; Livis 
7 ae 
' Furposes PUrecse: ff 
The SINGLE SPACE control word cancels a previcus DOUBLE SPACE The TAB SETTING control word specifies the tab stops to te 
contro) werd, and causes cytput te be single-spaced. assumed for the fcllcwing lines then converting the ‘TAB character 
inte the appropriate number of spaces. 
Forgat: 
Format: 
e ; ‘ 
{| 85 | ! ! ] 
| 1 { TB j n (1) n(2} nQ3) nq4) n (5) { 
-ccfe ! 1 ae i 
7 4 Be ee a en rape™ hoot? Wan” tn oy, PP gh ge RY ee gay gee a 
sage: : Ae 
. ni) specifies the ccluan lccation of the 
. _  {ijth tab stop, the seguence sust 
Cutput following the SINGLE SPACE ccntrcel word is single-spaced. censist of strictly nonotonically 
Since this is the nergal cutgut forrzat, SINGLE SPACE is only a increasing fesitive valves separated 
included in a°’file te cancel a previcus DOUBLE SPACE control by one or wore spaces. 
sord. 
; Usace: | = 
Note: : 
JAB characters entered inte the file during SCRIPT FDIT file 
This centrol word acts aS a BREAK. creaticn are expanded Ey SCRIPT PRINT irto che Or more blanks to 
; simulate the affect of a legical tak spet. The TAB SETTING 
: ccntrcl word specifies the Ilecaticns cf the logical tab stops, 
Exangle: this overrides the defult tah stops of 5, 10, 15, 10, 15, 30, 35, 
= : HO, 4S, 5C, £5, 60, 65, 7C, 75. 
ae 0SS : . an 
Single-spacing will resuse below this pcint in the file. A WTAE SETTING control vord withcut any tab stops specified, 


results in reversion to the default tab settings. This control 
word ais useful for indenting the ELeginning of a faragrarh 


({cerenmker a TAB causes 4 faragraph BRPAK) or for takulac 
inforpaticn and diagrans. 


Netes: 
ae This centrel word acts as a BREAK, 
Lt. The tak settings sust be sonotcrically increasing, tab 


settings that are net crdered will result in unpredicatable 
behavior. 


c. The right wargin is considered to be celugn 0. 


ae 
Tak 


Es 
lad 


“SCERIPT 


eTB iC 20 3C 4¢ 
etcpe are interpreted as cclunas 10, 20, and 30. 


eTE ; 
stcpe will revert to default values cf 5, 10, 15, etc. 
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teypry 
pa 
es 


TOE MARGIN Ccntrol tie. 
; Vile 


Purpose: 


fhe ICE MARGIN control 
skipped above the 
value of five. 


word specifies tte nusber of lines to be 
text cp cutput pages, overriding the standard 


n specifies the nustec of lines —- 
to be skipped at the tcp cf 
cutput pages. mn eust be three 
er greater. 


Usage: ' 


lines will te left at the top of 
befcre the first line of text. The page 
Flaced above the top nargin. If 
file, the default 
always be greater 


the specified nunber cf 
succeeding output pages 
nucker and heading, if any, are 
ne IGE BARGIN contro] word is included in the 
value is five. The TOP MAGGIN specified nust 
than the current HEADI3G HAFGIN. 


Note: 


this centxrol word acts as a BEEAK. 


Exanrle: 


a. oIK 3 ; 

three lines will he left at the top cf pages started after the 
current page. The heading and page nuster will be typed in the 
second line under default heading margin. 








-UNDENT Contre] Yon 
. WALD 
; Ge 
Purrese: : 07/7 


The UNDENT ccnt’rcl werd ferces the inseéiately Following line to 
start further left than the positicn indicated by the current 


indent. 
OrLmats 
J a | i 
1 .UN jf n 1 
} od 1 


n specifics the number cf spaces te be 
"undented" (negative indent) for the 
next Jine only, it must be less thar 
or equal to the ancuont of indent 
currently in effect. . 


Usace: 


Tbe CNEENT ccntrol werd serves the sane purpose as the OFFSET 
centro] werd but in a different sranner. It is usually used to 


sake the first line of a paragraph cr sectian extend further te 
the left than the bedy of the paragragh. 


The chcice between using UNDENT and CPFSET is usually a matter of 


perecnal Preference, In general, UNDENT is more convenient once 
cne becoses fapiliar with its usage. 


Notes: 


a 


ae This contrel acts ag a EREAK. 


Er. It dis avery severe errcr to specify an undentation amount 
that exceeds the current indentation amcunt. . 


xarsles: 


ae UN 1C 


If an indentation of IC is in effect, the next line will start at 
the left Bargin, all fclicwing lines will occur at norma) indent 
position, 10 spaces from left margin. 


, ~~ 
5/0 
scuipt 301.19-66 
etn 10 Weed 
she SCRIPT Example (fe 
ce 
SCRIPT Example 
@SE 2 
~ds 


This exanple..wil] denenstrate scne..of the-capabilities 
cf the SCRIPT command. This file was created by issuing? 
obr 

SCRIPT EDIT EXAMPLE 

eke os 

Since the file did net presicusly exist, the terminal 
was placed directly into the input envirennent. This 
paraaraeh was dcuble-spaced sith the .DS control. 

SS 

oSE 

Ko EBEAK was needed here, since the «SS (SINGLE- 
SPACE), ccatrc] acts af a break. Although this is 

in FORMAT mode, tabulac infcrmaticn can he included: 
aSE 


EPACE oSP «Sp. 
SIRGLE SPACE 55S «SE 
COUBLE SPACE | .DS das 
«SE 
The leading blanks caused each line to te handled 
separately. 
Sf 


Use, of the LINE LENGTE control allovs syace 

to ke left within a gage fer figures cr drawings. 
Naturally, it may take scne experirentaticn for 
findirg hew many paragraphs will fit next to a 
figure. ; 

oil 3¢€ 

SE 


{he new line length gust take affect 


at a paragraph, since it acts as a BREAK. the 
switch tack tc standard Line length, usvally 60, 
alsc is a BREAK, and must end a paragrayh. This 
werks cnly in FORMAT. node. 

-11 60 

otf 


‘Ey switching out of FCEMAT acde CAPTION 


and acing scene justificaticn 
by cye, fancier effects can Le obtained. This alse 
takes sone practice and experimentation. 


Figure 3,1.13-A. Contents of a SCRIPT file. 
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3.1.13-67 
FAFAGRAEHSS fe 
ekr 
If not space follows a paragraph heading, and if the Gb 


paragraphs are not indented, a BREAR is necessary in 

FCBMAT node, to keep the heading line fron being justified. 
A fev leading blanks are the casiest way to force 

a EREAK and separate paragraphs. A line with only a blank 

will alsc force a BREAK and a blank line, if the following 

line alsc Eegins with a Elank, as follcws: 


The CENTER control is handy for small figures 

included in the text. <A .CE in front cf each line cf 
the figure is necessary, and note that--leading or- ‘trailing 
blanks count for figuring the length tc be centered: 

=F 
“ce 
ce ‘i 
‘| FORMAT | EXAHPLB on jf 
ce ; . 


ce 
Figure EX.A . 
«Sp 
fo cffset the caption it weuld be necessary to leave 
trailing cr leading tlanks,y which are ccunted as fart 
of its lengths: ' 
sp 
“ce 
Ce 
Figure EX.A 2 
oSE 
The abcve caption has 14 trailing blanks, which nove 
it to the left. Leading blanks vould xecve it to the right. 


Pigure 3.7.13-4 (cont.) Contents cf a SCRIPT file. 
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SCBIET S8xanple tEG 
tt 


this exauple will denscnstrate sone of the capabilities of the 
SCRIPT ccrrand. This file vas created by issuing: 

SCRIPT ELIT EXAMPLE 

Since the file did net gprevicusly exist, the terminal was placed 
directly into the input environnent. This paraqraph was 
Gdoutle~spaced with the .0S control. 

No BREAK was ueeded here, since the .SS ‘(SINGLE- SPACE) cecntrol 


acts as a_tkreak. Althcugh this is in FORMAT node, takular 
informaticn can be included: 


SEACE SE «SE 
SINGLE SPACE .SS -5S 
EOUELE SPACE «DS ds - 


The leading Llanks caised each line to Le handled Separately. 


Use cf the LINE LENGTH contrecl allows space to be left within a- 
Fage for figures or drasings. Naturally, it ay take sone 
experirontation for findiog hcw sany paragraphs will fit next to 
a figure. 


The new line length rust 

take affect at a’ 

Fatagrafh, since it acts 

as a EREAK. The switch 

tack to standard line 

length, usually 60, alsc 

is a BREAK, and must end 

a paragraph. This werks 

cnly in FCENAT ncde. 

Ey switching out of FCENAT ucde CAPTION 
and dcing scse justificatica 

by eye, fancier effects can ke obtained. this also 
takes sone practice and experinentation. 


Figure3.1.13-A. Contents cf a SCRIPT file. 
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MiGs 
SCRIP1 Example | ole/ | 
 BARAGRAPHS: 3.1.14 SPLIT 
If not space follows a faragraph heading, and if the 
Paragraphs aree not-indented, a BREAK ig necessary in Purpose: 


FCEHAT mcde, to keep the heading line fren keing 
justified. ; 


A few leading blanks are the easiest way te it to a second card image file or creates a new file, “': 
force a BREAK and sé€parate paragraphs. A line with : 
cnly a blank will alsc force a BREAK and a blank line, Format: 
if. the follewing line alsc begins with a blank, as 1 eae eee ey aye, 
fcllcws: 


The CENTER ccntrel is handy fcr small figures 


included in the text. <A .CE in front of each line cE 90200 MUTT TERT Tree ree 
the -figure is necessary, and note thet leading or : eee 
trailing blanks count for figuring the length to ke filename] filetype} 
centered: 


filename2 filetype2 | 


1 FORMAT } EXANPLE n { 


Figure EX.A 


‘ i] 
“4 t : . : 
;SPLIT jfilename] filetype] filename2 filetype24 y} 
' t y 
' i 


(Ge 
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"0 SPLIT 


. The SPLIT con mand copies a specified port’on of a dard image file and a>pends 


a 


label 


~ 





wee ee ee 


specifies the file from which a portion will be copied. 
Pp P P 


specifies the riame of the file to which file] will be 


» added, 


An 8 byte alphanumeric label with the first character 
non-numeric specifying the first record to be copied, 


label2 An 8 byte alphanumeric label with the first character 
Ic cffset the caption it would be necessary to leave non-numeric specifying the item after the last item to 
trailing cr leading blanks, which are ccunted as part _ be copied, 
cf its length: : : 
. ni A decimal number specifying the item number of the 
-~ creer ere - ce +--+ is first item to be copied, 
Figure EX.A 
; n2, A decimal number specifying the number of items to 
The akcve cagtion has 14 trailing blanks, which move it be copied, : 
to the left. Leading Elanks would acve it to the 
right. Usage: 
Figure3.1.13-A (cont.) Contents of a SCRIPT file. The SPLIT command enables the user to copy a portion of file] and append it to 


file2, Filel and file2 cannot be the same file. If file2 docs not exist, it will be 
created, The files must have fixed-length records of 80 bytes per record. 


; Copying begins at either the first record containing the alphanumeric string, 


Jabell, in the first cight bytes cf a record (label field), or at the specified 
item number if the parameter consists of all numeric characters. 


If the last parameter is not provided, copying continues to the end-of-file. If the 
. last parameter is specified as an alphanumeric label, copying, once initiated, 
terminates immediately before the first item having the alphanumeric string, 





label@, in the label ficld of a record, The extent of copying may alternatively 
be specified by an integer count of the number of items to be copied. 


Yee 
1/01/68 
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SPLIT 


No copying is done if 1) labels are used for both starting and stopping the 
copying and these two labels are identical, 2) the initial label or item 
number cannot be found, or 3) the number of items is specified as zero. 


Responses: 7 


WRONG NUMBER OF PARAMETERS 
The specificd number of parameters given is not five or six. 


- 


INVALID JUIMIT 
One of the limit fields is specified with the first character numeric and 
one of the other characters non-numeric. 


EOF REACHED ho ee 
The end of file] has been reached with or without copying being initiated. 


FILE NOT CHANGED 
The command has been completed without any writing of files. 


FILE MODIFIED 
The command has been successfully completed and at least one item has 
been copied, . 


Any error encountered in the reading of file] will terminate the command after 
printing one of the following responses: : 


TYPE NOT FOUND iad 
DISK ERROR , 
ILLEGAL MODE | 
NONSTANDARD FILE 
BUFFER TOO SMALL 
OPEN FOR WRITING 
OPEN FILIE LIMIT 
F/V FLAG WRONG (file of variable-length items) 

Any error encountered in the writing of file2 will terminate the command after 
printing one of the following responses: 


BAD OUTPUT TYPE 
ERROR ON DISK 
ITEM SIZE? (items vary in length) 
OPEN FOR READ 
- TOO MANY FILES 
DISK FULL 
READ ONLY 


11/01/68 
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og, SPLIT. 


yy, 
uot 


Examples: 


a) SPLIL FILE DATA F) DATA 45 le 

The 12 jtems b ginning*with the 45th item ar- extracted from the file 
FILE DATA and added to the end of the file Fl] DATA if Fl DATA exists 
or creates the file F] DATA if it docs not already exist. 


b) SPLIT ABLE SYSIN ABLE] SYSIN BEG 20 a 
The 20 items beginning with the item which has a label field containing 
BEG are extracted from the file ABLE SYSIN and are appended to the 
file ABLE) SYSIN if it exists or creates the file ABLE! SYSIN if it 
docsn't exist. 


c) SPLIT PROG SYSIN PROGEND SYSIN END ; 
Items beginning with the item with END in the label until the end of file 
PROG SYSIN are used to create a new file called PROGEND SYSIN if 
PROGEND SYSIN does not exist; if PROGEND SYSIN does exist, those 


items are appendcd to it. 


Error Messages? _ 


The SPLIT command diagnoses all errors which occur and prints a 
response message indicating the nature of the error, All returns 
from SPLIT are with general register 15 equal 0 indicating no error, 
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3.1.18 TAEE VG 
KOS 
ENITECSe: 
The TAFE command copies files from disk to tape, reccpies such 
tapes to the permanent disk, writes tape marks, fositions the 


tape, and scans the tape for file identifiers. 


fermat: 

Se a eel pee shes et ln fat Cad ie, saat test Ae AP ek tea ns ee I ee RI I oe 
| { ; I 
i |  CUME filename filetyfe <filemode> { 
1° } LOAL n * a 1 
! 7s | ‘. | 
{ JAEE } I 
1 } RERINE ae TAP n ! 
| | SCAN Bc TAP_2 l 
1 ) SKIE on . | 
! | A ! 
J 1 SLCAEL filename filetyrfe | 
| [ &RITECE : i 

DUMP specifies a disk file is to te ccpied 


to the mcunted tare. 


4 
* 


filename Eslctipe <filencde>d specify the file tc be 
copied. The filenode is ofticnal and 
cefaults tc F1. 


* 


4 ; reans either all filename, all filetypes 
cr all files cf the specified mcde. 


LCAD nh epecifies all files cn the mounted tape 
tefore the next "n" tapemarks are to be 
copied tc the pernanent disk. "n" 
defaults to 1. 
REWIND positions the tape at the load pcint. 
SCAN types cut the identifiers of the files 
that exist on the tape in a tape-dump format. 
SKIF n poritions the tape after the next "n" 


tazyemarks. "n" defaults to 1. 


SLCAL filenane filetype ecans the tape fcr "filename 


ics 
tes 


PESEC: 


1 


. 05/01/69 
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filetype" and loads it onto the permanent aos 
disk. AE 
AB n. specifies the synhbclic tare unit of Wt G 
the tape to te written, loaded, cr positioned. 
TAP2 is the default, which corresrpenis to 
tape address 781. — 
ge: . 
Filenare and type or asterisk must be gpecified for a TAFE LUMP 
ccirand, If filemode is omitted, F1 is assumed. Files may 
contain fixed or variable length records. The specified file is 


first ccpies to a disk utility file, then te the tape mounted at 
virtual device address 181. No end-of-file mark is written after 
the data transfer unless a TAPE WRITECF ccmrand is issued. The 
last record of the tape file is EpagaSe and contains directcry 
infcrmaticr for TABE LCAD. 


The TAFE ICAD command copies 
the permarent disk. The 


any number of files fror tke tape te 

filenanes and filetypes are oktained 
frcem. the tare, and may net be specified with the ccmmand. The 

-£ilewode cf all files is P1. ‘Any existing file on the pferranent 
dick with the same designaticn ag cne cf the tape files is erased 
and seplaced. whenever a flaqged directcry record is encountered 
on the tape, the file keing written on disk is closed, and a new 
file ig started. Reading ccntinues to the "n“ tapemark written by 
TAFE WRHITECF. 


The TAPE FEWINE 
foint. 


ccnmand positicns the tape reel at the load 


and types out 
tapemarks are 


The TAFE SCAN command reads through "n" tapemarks 
the identifier cf the files cn the tape. If two 
encountered, TAFE SCAN terminates. The TAPE SKIP positicrs the 
tape after the next “n" tapemark enccuntered, skipping the file 
at the current positich. Use of the TAPE WRITEOF and TAPE SKIP 
éllows access tc individual] files cr groups cE files. 


“The TAFE SIGCAD ccmmand 
loads 


scans the tape fcr the specified file and 
it crte the Ferrane nt disk with mode P1. 


The TAPE tKhITEOF 
currently pesitioned. 
end-of-file. 


command writes a taperark wherever the tape is 
The tapemark is reccynized ky TAPE LCAD as 


£Eses? 
a. filename filetype P1 LOADED. 
TAFE LCAL gives this response aS each file ccpied frem tape is 
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completed. This response is followed Ly the Ready ressage after TAPE LUMP FILEB TEXT PS Shel oe 
Chests eh aAee: TAPE WRITEGF AGES 

07 “TAPE FEWIND Lb F 
‘Le DUMNEING...« 
This scries of commands copies two user files to tape. (In this 
Lisk files are teing dunped tc tare and their identifiers are and the fcllowing examples, the Ready massage following each 
typed cut as they are dumped. coumand is omitted.) The initial TAPE RFWINE positicns the tafe 
: ‘ at the lea¢ point. FILEA is then ccpied, followed Ly the flagged 
ditectcry record. The next record is the first of FILF5. TAPE 
Ce TAE n NCT REALY YET ; WRITECF places a tapemark after the directcry record cf FILEB, 
and the final ccmmand reycesiticns the tape to the load point 
The tape is attached but not physically in a ready status. again. 
i. (OK ~ READY NOW) : . : : be 
: ; TAPE SKIP 
Ihe attached tape has keen readied and can ncw be used. TAPE LUMP SYSLIE MACLIB SY 
. : TAPE WRITEOFE 
: : TAPE, FEWIKD 


e 
4 . : - Assuring the same tape is mounted as in the frevicus example, 
a. The TAFE ccosand can be used with a ?~track tare, density 860 this serics ct ccmnands copies SYSLIB MACLIB onto the tape after 
Pi, ccnverter on, and translator off. the tapemark following FILFE. A tapemark is written follcwing 
the directcry rcecerd cf SYSLIB, and the tape is rewound to the 
. dead feint. 
ke. Failure to issue a TAPE WRITEOF after the last file copied te : 
{ tape will cause an €rrer on a subsequent TAPE LOAD. 7 


Ce 


; TAPE LOAC 
ce The (EXEC) form of the LISTF command is useful fcr ccprying ; ye 
all files, cr grcuzs cf related files. ‘ 


Again using the same tape, this ccmrand will erase FILEA from the 


; : ; - . disk, and replace it with the tape cory. When the directery 
i. TAEE CUMP and TAFE ICAD are valjd even if the size of - gpecerd is yrecessed, the fcllowing response is typed: 
location cf the virtual disk is redefined retween the ccmmands. : 


FILEA TEXT P1 ILGADED. 
e. ‘Tape records written ty TAFE CUMP are 805 bytes lonq The 


first character is a tinary 2 (hex 'G2'), followed by the 


characters CMS and a Elank (hex '40'), followed by 800 bytes of . Note that the mede ig now P1. Because there is ne tapemark 
file data packed withcut regard for logical record length. In follewing FILEA, FIIES8 is read and replaces the disk copy of 
the final reccrd, tke character N replaces the blank after CHS. FILEE. The response 

The data area contain directory information (see Preqranr Leqic | 

Manual). : : 


FILFE TEXT 1 LCALFE. 
f. Under CF-67, all tare units must te attached to the CMS user 


tefcre any tape IvO can cccur. Refer tc Section 5.5.0 "Tape is fcllcved by the’ Ready message when the  taremark is 
Exccedures" for information on the attachment of tapes. encountered. ° 
Exaigles: Ancther TAEE LCAC command would now copy SYSLIB MACLIRBR onto the 


: . permanent disk as SYSLIE FACLIB Pi. SYSLIB MACLIB SY¥ cn the 


system disk would nct be erased. 
a. 


TAPE REWIND 
TAPE [TUUP FILEA TEXT ES . Error fessages: 








E (C0001) ISVALIE COMMAND FCRMAT 
The fermat of the ccnuand was inccrrect, or the operation 
Specified was unknown, Retry the ccnsand. No operation was 
perfcrmed. 


E(CCC01) FILE filename filetype filerode NOT FOUND, 
The file specified with TAPE DUMP was not found. No 
oferations waS performed. Check the file designation and 
retry the cemmand. 


£(000U2) FATAL TAFE ERRCK WHILE WRITING. 
An I7C errer cccurred which cculd nct ke corrected hy 10 
tetries. Nctify the cperator to replace the tare. This 


messace is also issved for errors during tape ccntrol 
oferaticns (REWIND, WRITECF, SKIP). Jf TAPE SKIFE was issued 
at a foint heyond which no tapemarks existed, the tape sent 
to ¢nd-cf-recl. A subsequent DUMP, SKIP, or BRITEOF results 
in this messace. . 


E(CCCO2) TAP n IS FILE PROTECTED 
FATAL TAEF ERROK WHILE WRITING, 
The cing ig nct in the tape, therefore writing can not 
OCCUL, 


£(C0G02) TAP n NOT ATTACHEL 
FATAL TAPE ERECK WHILE WRITING. 
The tape is ret attached, therefcre jit can nct be “used. 
Refer tc Tape Procedures in Section 5.5.0 for information on 
tapes. 5 


E(cO0C0Z) . DISK ERBROR WHILE KREALING, 
An lyC error cccurred while the file was being transferred 
to cr frem the disk utility file. Retry the command. If 
the .€reror recurs, notify the operator. If the file was 
delete-after-reading, see COMBINE, Note b. 


E(aCcCcCc3) FATAL DISK ERROR, 
An Iy€ erroc occurced, or, for a DISK LOAD, the disk may he 
filled. To retry the command, reposition the tape with a 
TAPE, REWIND and the necessary number of TAFE SKIP commands. 
If the error recurs, notify the operator. 


S(CCCO3) — CISK ERBCK WHILE WRITING, 
An lvC e€rrer cecurred during transfer of the file to or. from 
the @isk utility tile, cr the user's disk is full. Retry 
the ccmmand. If the error recurs notify the operator. If 
the fjilercde wag delete while reading, see COMBINE, Note b. 


05/01/69 
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0G 
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é rs fit yt 
F(COQ0Q4) FATAL TAPE ERROR WHILE READING, eae 
An IyC error cccurred. A tapemark ray not be at the and of 
the tape. Repcsiticn the tare and retry the command. If the 
ercor recurs, and the file has not been loaded, part of the 
file may ke recoverable under the desiqnation (DISK) (TEMP). 
See F (00006). ; F 


E (C0005) “TAPE IS NCT IN "TAEE LOAL" FCEMAT. 
A tape record was read which was net written by TAPE DUMP. 
The strong tape is mounted, or reading has centinued past the 
end cf TAPE DUMP cutpyut because neo tapenark was read. 


£(CC006) ENDING RECQRD GF FILE MISSING, 
A tapemarx or end-of-reel was encountered before the flagged 
directcry reccrd cf the current file. Part of the file may 
be recoveratle under the desiqnaticn (DISK) (TFILE) P3. 
Note that the mode is delete-after- reading, gc an ALTER or 
COMBINE ccmmand must te issued before inspecting this file. 
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TXELIB X< // 


3.1.16 TXTLIB 


Purpose: 





The TXTLIB command cither (1) generates a text library, (2) een 
an existing .ext library, (3) deletes from an existing text li ek Ys ie 
(4) lists the entry points and control section names, the location, 

the size of the TEXT files included in the text library. 


Format: 
ieee Se eS scm ee 
poe libname filenamel...filenameN : 
‘ id : G . 
: { ss libname filenamel...filenameN 
' 53 a 
{ ' Es 
. (DELETE ) 
TXTLIB) ; ‘ libname csectnamel,.. csectnameN 
‘ ' 
f 
; or } ' ae } libname 
; ; IST | ' 
: ee } libname : 
Oo ood. Soa ee Bo a ses es ae re er ee we ee 
TENERATE creates the text library "libname" from the specified 
{6 file(s). 
ADD adds the contents of the specified file(s) to the existing 
{iA } : text library "libname". 
DELETE} deletes from the text library "libname" the specified 
[ } control sections (csects). 
: 2 2 . . list 
4 creates the file "libname MAP P1" containing a ti 
ol "| of the entry paints and control section names of the 
. TEXT files in the library, their location, and the 
size of the TEXT file. 
_ i i i he infor- 
7 rovides the same information as PRINT, but th 
ee ration is typed out at the terminal instead of being gen- _ 


erated into a MAP file, 


3.1,16-2 BP 
TXTLIB LZ 


libname is the name of the text library to be generated, added 


to, printed, or listed, The filetype of libname must 
be TXTLIB. See Se 





filenamel...filenaymcN specify the file(s) to bc used in the cither gencratine or 


adding to a TXTLIB file, Their filetype must be TEXT. 


csectnamel,., csectnatneN specify the csect(s) to be deleted from a TXTLIB 


file, Entry points which are nei ssectnames are ignored. 


Usape: 


A text library is a file that has a filetype of TXT LIB and that contains 

a dictionary and the rclocatable object code from TEXT files, The dic- 
tionary is ercated by the TXTLIB command which contains the entry 
points and control section names, their location, and the size of each 
TEXT file included in the text library, The relocatable object code in 
TEXT files can be created by the Assembler, Fortran, or PL/I compiler. 


There are five forms of the TXTLIB command: GENERATE, ADD, 
DELETE, PRINT, and LIST. 
The GENERATE form of the TXT LIB command generates a text library 
from the specified file(s) and assigns to that library the identifier "lib- 
name TATLIB Pl", If a file already exists with the identifier "libname 


TATLIB Pl", the existing file will be erased; and the new file will be 
created, 


The ADD form of the TXTLIB command appends the contents of the speci- 
fied TEXT files to the end of the existing text library, 


The DELETE form of the TXTLIB command removes the specified 
control sections from the file hbname TXTLIB, If a TXTLIB file has 
two control sections with the same name only the first one is deleted 
(unless the csectname is given twice in the argument list), The order 
of the csectnames given in the commend argument is immaterial. 


The PRINT form of the TXTLIB command generates the file "libname 
MAP Pl" on the permanent disk. If a file already exists with the same 
identifier, it will be crased and the new file created, The “libname 
MAP" file contains the same information as that in the dictionary of the 
specified text library and is in the format of a list of entry points and 
control section names that reside in the text library, their location or 
index in the file, and their size in number of card images, 
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The LIST form of the TXTLIB command types out the contents of the 
dictionary at the terminal and does not generate the. file "libname 

MAP PI", For an example of the TXTLIB LIST command, see FIGURE 
3.1,16-A. The pound sign (#) indicates the first control section name in 
the fila, 


Both the PRINT and LIST forms of TXTILIB type out a statement indicating 
the total number of entry points and control section names that curr ently 
exist in the TXTLIB file. 


For the usage of text libraries, refer to Sections 3, 2,2 and 5.4.0, 


Notes: 


a. Each TEXT file that is to be included in the TXTLIB file must consist 
of one or more control sections with an END card image following each 
control section. This format will be automatically generated by the 
ASSEMBLE and FORTRAN cornmands. 


b. With the TXTLIB ADD command, the TEXT files are added to the end of 
‘the existing TXTLIB file and no checking for duplicate eniny points or con- 
trol section names will be performed. 


c. The total number of control section names and entry points in the 
TXTLIB file cannot exceed 256, When this maximum number is reached, 
an errar message will be typed out. The text library created will include 
all the text files entered up to but not including the one that caused the 
overflow, 


Responses: . 


xxx ENTRYS IN LIBE 
When -TXTLIB is issued, the contents of the dictionary of the specified text 
library will be typed out. See FIGURE 3,1.16-A. The number of entries xxx 
in the text library will be typed out when either TXTLIB LIST or TXTLIB 
PRINT is issued. 


Examples: 


a. TXTLIB G SSP MEGOP MEG OPS 


The file SSP TXTLIB P1] is generated from the files MEGOP TEXT, MEG 
TEXT, and OPS TEXT. If SSP TXTLIB P} alr eady exists, it will be erased 
and the new file created, 


b. TXTLIB ADD SSP MYROUT 
The contents of the file MYROUT TEXT will pe added to the existing file 
SSP TXTLIB. No checking for duplicate entries is performed. 
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TXTLIB 2 


ABA 


yl 


ec. TRELIB DEL A SUBD# : 
The control section SUBDI in text library A will be deleted, 
cludes entry points SUBD and SUB} (see FIGURE 3,1, 16- A). 


This in- 


qd, TXTLIB PRINT ABC 

The file "ABC MAP Pl" is generated on the user's permanent disk con- 
taining the aictionary information from thé file "ABC TXTLIB", The 
number of entrics in "ABC TXTLIB' is typed out, 


e. TXTLIB LIST SSP 
The dictionary of the file SSP TXTLIB as well as the total number of 
entry points and control section names will be typed at the terminal, 


Error een 


(£00001) A FILM 1S MISSING : 
Either the filetype of "ibname'" is not TXTLIB or the filetype of “file- 
namel,. -filenameN" is not TEXT, 


(3200002) A FILE HAS WRONG RECORD LENGTH, 
One of the TEXT files does not have 80 character records and, there- 
fore, it has an incorrect format, Re-compile or re-assemble the source 
language file and then issue the TXTLIB command again, 


(00003) ERROR WHILE RE ADING 
An error occurred while either the TXT LIB file or a TEXT file was bei ng 
read, The command has terminated, 


(F00004) ERROR WHILE WRITING, 
An error occurred while writing the ARON file, The command has ter- 
minated, 


(00005) J IBRARY NOT FOUND. 
The file "libname TXTLIB" does not exist. The command hes terminated, 


(00006) XXXXXKK CAUSED OVERFLOW --- OK UP TO THERE 
The maximum number of entry points and control section names (256) in 
the TXTLIB file has been reached, No additional TEXT files may be added, 
The control section that caused the overflow is not included in the text lib- 
vary created, ; 
(00007) ERROR, FILENAME MAY BE DUMMY 
ALTER failed, This means that your original text library is lost but the 
new version may existas +**DUMMY TXTLIB. 


(1500008) XXXAKX,XXXXXX NOT FOUND,... OTHERWISE OK 
A list of csectnames not found in the specified text library is printed above 
this comment, The presence of such csectnames docs not interfere with 
the deletion of ones that are found. 


11/01/68 
ee 3.1.16-5 
x TLIB 
AEE: Z, UPDATE 
(£00009) WIPEOUT!!! ; . “2 = _ 
: All csects have been deleted. No text library is left. urpose: 
&000010) CSECTNAMES MISSING : The UPDATE 
No a nanes were specified with TXT UIB DE LETE, 
£00001!) BAD FORM panes 
cone forms must start with G, A, D, L, or P. 
| {urparz) 
5 eve ieee H 
° filename] 
Fi filetype] 
* filenameZ2 
; . filetype2 
(P) 


Control Cards: 


cornmand makes changes in a specified file 


1-22-68 
3.1.17-1 


UPDATE Abs 


according to 


control cards in a second file. 


CO ee ee 


1 
filenamel [ritetype 1 filename2 filetype Z]] [Py] 
ne ee ae ee cee Ce OR ONE tere J 


is the name of the file to be changed. 


is the type of the file to be changed. 
SYSIN is assumed, 


If omitted, 


is the filename of the file containing the UPDATE 
control cards. If omitted, filenamel is assumed. 


is the filetype of the file containing the UPDATE 
control cards. If omitted, UPDATE is assumed. 


specified the file incorporating the changes is to 
replace the original file. If omitted, the old file 
is retained unchanged, and the new file receives a 
filename consisting of a period (.) followed by the 
first seven characters of the or iginal filename, 


Changes are made in the original file according to the UPDATE control 


cards in the UPDATE file. 


é heist aah as 
bots Sed. 
S 
* seqnol 
increment 
label 


The format of these cards is shown below: 


specified the new file is to be sequenced in columns 
76 through 80. If this card is included in the UPDATE 
file, it must be the first card. 


specified the starting sequence number. 


specifies the increment to be added to the sequence 
number for each item. 


is a three-character label to be placed in columns 
73 through 75, 





Ds i. 


1-22-68 
3.1,17-2 
UPDATE 
| esas Be fete a Ne Aan TV i 
1 ./ D = seqnol seqno2! 
few ewe ee ee ey t 
D specifics cards are to be deleted from the original file, 
seqnol is the (ori ginal) sequence number of the first card to be 
deleted, 
seqno2 is the sequence number of the last card to be deleted. If 
: omitted, only one card is deleted. 
ween ene teem mena 
t i 
1 ./ I-+seqnol ! 
ieeece ein er Pee 4 
I specifies cards are to be inserted in the original file, The 
inserted cards must follow the ./ I card immediately in the 
UPDATE file. All cards until the next control card are inserted, 
segnol specifies the sequence number of the item after which the 
cards are to be inserted. 
foo = ot a aa na et a eer | 
' ./ R_ seqnol seqno2 ! 
HD ios Se heat abi ered ote J 
R specifies cards are to be inserted in the original file 
in place of cards now there. .. 
seqnol specifies the first card to be replaced. 
seqno2 specifies the last card to be replaced. The cards to be 
inserted in place of those deleted (not necessarily the same 
number) must follow the ./ R card immediately in the 
UPDATE: file. 
Usage: 


UPDATE modifies the specified file according to control cards in a second 

file. The filetype SYSIN is assumed for the file to be modéfied, if no other 

is specified, The control-card file normally has the sme name as the file 

to be modified, and the filetype UPDATE. It will be referred to as the UPDATE 
file, with the understanding that both a different filename and filetype may be 
specified with the UPDATE command. Note that if different identifiers are 
specified, the filetype of the file to be modified must also be included. '(F)" 
must always be the last argument, if it is included. 


ere 


i 
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UPDATE generates two files during execution: "filename UPDLOG P5"' 

and "filename INTER P5,'' where "filename" is that of the original file 

in both cases, The UPDLOG file contains a record of the control cards 

in the UPDATE file, items added and deleted from the original file, items 
added and deleted from the original file, and error messages. A new 
UPDLOG file is generated on each execution, replacing any cxisting UPDLOG 
file with the same filename. 


The INTER file receives the records of the original file as changes are made. 
At the cnd of execution, the identifiers of the INTER file are changed to one of 
two formats, depending on whether (P) is specified with the command. If (P) 
is specified, the original file is erased, and the INTER file reccives its file- 
name and filetype. If (P) is not specified, the original file remains on the 
permanent disk unchanged, The new file receives the same filetype and file- 
mode, and a filename composed of a period (,) plus the first seven characters 
of the original filename. a 


The control cards of the UPDATE file always refer to the items of the original 
file by the sequence numbers existing before any changes in columns 76-80. If 
no scquence numbers exist, issue a preliminary UPDATE command with only 
the ./ S control card in the UPDATE file. Sequence numbers will be assigned, 
The control cards must always be identified by a './" in coluinns one and two, 
but any number of blanks may separate the other fields, Sequence numbers may 
be expressed with up to five digits, but leading zeroes are not necessary. Any 
sequence numbers in cards to be inserted in the file are ignored. Ifthe ./ 8S 
control card-is omitted from the UPDATE file, asterisks will be placed in 
columns 73-80 of all cards in the new file which were added or replaced, to 
indicate where changes were made, 


Changes are made in order in a single pass through the file. If control cards 
specify changes that are not in order, an error is recorded and no changes are 
made, 


Responses; 


INTERMEDIATE FILE EXISTS, 
The file "filename INTER P5"' already exists for the filename specified. 


ERASE or ALTER this file, and issue the UPDATE command again. 


FATAL ERROR 1 
A control card was detected in the UPDATE file whose second field was not 
the character R, I, D, or S, . 


FATAL ERROR 2 
The file to be chanyed is not on the permanent disk. 


okeres 
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- UPDATE urease 
RET CSECT . 

READ ERROR or WRITE ERROR ENTRY RETCODE one 
An error occurred reading or writing to the permanent disk. BALR 12,0 RTNOO150 
USING = *, 12 RTNOO175 
PARAMETER ERROR L 15, RETCODE , RTNO0200 
No parameters were entered with the command. | BR 14 RTN00225 
| RETCODE DS F . RTN00250 
re filename filetype NOT FOUND END RTN00275 


The file identified in the response was not found in the user's file directory. ; 
RET UPDLOG P5 is also created, containing the cantrol cards, and all items 


added or deleted, 


ERRORS ENCOUNTERED. SYSIN REMAINS UNCHANGED. 
This resonse is issued for all of the above error conditions. It indicates 
control is about to return to the CMS command environment, and that no Error Messages: 


changes have been made to the files. 
"se E(00002) FATAL ERROR 3 
Example: 


a. UPDATE RET 


An error occurred while attempting to change the identification 
of the INTER file. Enter the command 


a Assume that the file RET SYSIN 'P5 contains these items: : . ALTER fnl INTER * {nl filetype * 
| : — RET veers aie Ree where fnl is the filename of the file changed, and filetype is 
7 BALR , RE" the desired filetype. If another error occu 
; : 
USING ¥*, 12 RE1T00030 Sommand epi : rs, enter the UPDATE 
4 SR 15,15 , RETO000410 
END ° RET00050 ’ 


Assume that the file RET UPDATE P5 contains: 


B ./ S 100 25 RIN 
./ 1 


10 
: ENTRY RETCODE 
/ R 40L - 
a * -pD'. 15, RETCODE 
BR 14 


RETCODE DS’ F 


_As the command is executed, the file RET INTER P5 is created. As items 
; are placed into it, "RTN' is placed in colums 73 through 75, and sequence 
: numbers beginning with 00100 and incrementing by 25 are placed in columns 
76 through 80. On completion, the file becomes .RET SYSIN P5, and contains: 


\ 


~ i 
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3.1.18 TAPRINT 
Purpose: 
TAPRINT copies files from a specified tape to the offline 


printer. The files must be LISTING files created by the 
WRTTAP or ASSEMBLE commands. 


Format: 
a aS ies Oe act t 
Ne [rapa]: 
ht TAMEG 2 loot cutee _ 
' + TAPn is either TAP] or TAP2, specifying which tape 
is to be copied, If omitted, TAP2-is assumed, 
Usage: ° 


TAPRINT prints tape files in the special format written by the 
LTAPn option of the ASSEMBLE command and by the WRT TAP 
command, Printing starts wherever the tape is positioned when 
the command is issued, and continues until two consecutive end-of- 
file marks are encountered. Single end-of-file marks are ignored, 
except for a message. On completion, the tape is rewound. 


Responses: 
te pe 


EOF READ ON TAPE 


A single end-of-file was read on the tape. Printing will continue. 


PLEASE READY THE PRINTER 
This message shouldnot occur under CP, 


END OF TAPE 
Two consecutive end-of-file marks were encountered. The tape 


is being rewound, and control will be passed to the CMS Command 
environment. ’ 


PERMANENT I/O ERROR ON TAPE. 
An I/O error occurred. The command is terminated. 


Examples: 


TAPRINT TAP 1 
All the files up to the first two consecutive end-of-file marks on 
the tape mounted on TAP! (at 180) are assumed to be LISTING files 
and are printed on the offline printer. . 


Error Messages 


E (00001) SYMBOLIC TAPE ADDRESS INCORRECT. 


The symbolic tape address specified was not TAPI 
or TAP2, No action was performed, 
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3.1.19 WRTITAP 
Purpose: 
WRI'TAP copies fixed-length format files from disk to tape. If 


the filetype is LISTING, assembler and compiler carriage-contro: 
codes are translated to machine codes, 


Format: 
T ee a Or. ee ee ae oe r SS SS ae me ee ae See a a ae 7 * 
teas: filename filetype i 
4 . 
a a) 8 ees nee a 
filename — specifies the file to be copied. 
filetype 
Usage: 


WRTTAP copies files from any disk to TAP1. Records are 

blocked in’groups of ten, and the record format must be 
fixed-length less than 256 bytes. No end of file is written 

on the tape, and the tape is not rewound when the command 
completes. : . 


Although WRITAP handles any file of the format described 

above, it is specially designed for LISTING files created 

by the ASSEMBLE and FORTRAN conmands. These files contain 

a carriage control code for the offline printer as the first 
byte of each record. WRITAP translates the code into a 

machine code for the printér. Files are written on the tape 

in the same format as if the ASSEMBLE command had been specified 
with the (LTAPn) vption. This format is acceptable to the 
TAPRINT commana. 


Notes: 

a. WRTTAP does not write an end of file on the tape on 
completion nor does it position the tape past any 
existing files. Use the facilities of the TAPE command 
for positioning. To mark an end of file for TAPRINT, 
write two end-of-file marks. 

b. Under CP, the tape must be attached by the operator. 
WRTTAP expects TAP1, addressed at 180, which should be 
specified when you request the operator to attach the 
tape. 

Cc. : Tape files written with WRTTAP are not suitable for re- 


reading with TAPE LOAD. 


Responses: 


None. | 


J | a | | 7 
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Example: 
a. WRTTAP PROG LISTING 


The file PROG LISTING P5.is copied to tape, with carriage- 
control codes translated to machine todes, and records blocked 
in groups of 10. If this is to serve as input to the TAPRINT 
command, the following commands should be issued: 


TAPE WRITEOF 
TAPE WRITEOF 
TAPE REWIND 


Error Messages: 
ror Messages: 


£(00002) PARAMETER ERROR 


Two parameters (filename and filetype) were not 
specified. 


E(00003) VARIABLE LENGTH FILE 


WRITAP does not handle files with variable record 
length. 


E(00004) FILE NOT FOUND . : 

No file with the specified filename and filetype was found. 
£(00005) FATAL ERROR ‘ 
An error occurred reading the file from disk. 


E(xxxxx) TAPE ERROR 


A tape crror occurred which could not be recovered, 
The error code is unpredictable. 


Need 
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| . ied en 
3.1.20 STATE tHE 2.23 
Eurecse: 


the STATE command tests whether a file exists. 


Fornat? 


- = «wo em ew oe KH FF FOOTE Tre 


When STATE is issued fer a file which exists, the command returns 
with a. cede of zero. If the file does not exist, a non-zero 
errcre code will te returned. The mcde must be specified as P, T, 


er Se: 


E(CCCO1) File specified dces not exist. 
£ (00004) First character of filemode illegal. 


’ 


3.1.21 TAFEIO 


The TAFELC command either writes a 
erases a gep, cx moves the tare. 


_— eee 


Format: 
} TAEEIC 
1 
TAP 1 
TAP2 


Functions Are: 


ccrresponds to device 180. 
ccrresponds to device 181. TAP2 is 
assumed if ne tape ig specified. 


BSE to 
BSR to 
ERG to 
FSF tc 
FSR to 
REWINE to 
_ RON £o 


WRITECF tc 


WIM 


ies 
tn 
ie 
ka 
Ip 
on 


to 


backspace one file 

backspace on record 

erase a gap 

fcrward space one file 
forward space one record 
rewind the tape te lead foint 
rewind and unload the tafe 
write a tare mark 

woite a tape mark 


tame 
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MAE 


The tape cn the specified device is meved a single record or 
file as indicated or is rewound and/or unlcaded or a tafe 
mark (End-cf-file) written fer a gap is erased.as indicated, 


Nctess 


1. The mcedeset is set to X"FF*, therefore, either 9-track 


tapes with density 800, cdd farity, and converter 
eff can te manipulated sith the TAPEIO command. 


If other 


modes cf tapes are to be used, TAPFIG should be called as 


a functicn frem an Asserbly Language program (See 3.4.-164511). 


er : 
t iva 
os Pee ge 


ina 
Loa 


tape mark on a magnetic tafe, 


-/;/ 


2. The KEKIND and RUN f£unctions indicate completion befcre the 





Lr 


a 
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physical operation is cenpleted. Thus a subsequent operabibae?? : 3.1.21-3 
-to the same physical device may encounter a device busy CES CEE 


i ict. ; i 
situation Ax 7 £ (00007) TAPn - SERIOUS TAPE ERROR ATTENETING function g2P 


An unrecoverable tape error has occurred on the tape while 


3. The TAEEIO command ig identical te the TAPEIO function (section. attempting the srecetied FuNcescns 


3.4.1.4.-11) except that TAPEIO READ and TAPEIO WRITE 

cannct be executed from the command level at a terrinal. 

If eitker cf these igs atterfpted, an apfrepriate error message 
and error code are given. (see below) 


TAEn NOT KFALY YET. 5 

Tne specified tape has been attached but it is not ready yet. 

Ine following message will ke received when the tape drive is 

in a ready status. : - 


(CK - REALTY NOW) 
The attacked tape is new ready for use. 


FPS an eon Bee} 


E (0000 1) 
dn invalid function was specified. 


£ (00002) 
An end-cf-file or end-cf-tafe has been reached. 


§(C0C03) 
A permanent I/C error has eccurred while reading 
cr writing the tare. 


E(C0C04) 
An invalid symtolic tafe unit was specified. 


E (c€C05) TAPn NOT ATTACHED. 
The specified tape is not attached, therefore the 
functicn can not occur. 


E (00005) ; 
Same as previous message, but the message cnly prints 
the first time this error occurs. 


E(COC06) TAPn IS PILE FROITECTED. 
the specified tape contains a file-protect ring, 
therefcre the tape can nct be erased or written on. 


. 6 
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3.1.22 DUMPD 


PURPOSE: 


The DUMPD command prints the contents of one or more direct access 
records, specified by either a CCHHRR address or a BBBB number, 
in hexadecimal on the printer. 


FORMAT: 
Ge ee ee ERs ay eg ee ee Ren ad ; 
bbbb {bbbb] i 
'  DUMPD ! ccu cc (hh [rrJJ 
Be ea te eee ee ee 
ecu | is the device address 
ech: rr 7 is the cylinder, track, and record 
number to be printed 
bbbb is the data block number 
USAGE: 


The contents of the specified record is printed in hexadecimal on 
the printer. If cc hh rr or bbbb is not specified or if one record 
has been printed, DUMPD requests another record address, To 
terminate DUMPD, issue a carriage return with no characters on the 
line. For more than one record: 


1. Omit rr for printout of given track (head); 

2. Omit hh rr for printout of given cylinder; 

3. Specify bbbb bbbb as the beginning and end of the data 
blocks to be printed. 


RESPONSES: 


CC HH RR 
BBBB 


‘Prompting will depend on the previous mode of input. Specify 
another cylinder, track (head), and record number or data block 


number. User may change input mode at any time input is requested, 


The change will be reflected on the next input prompt. 


CORRECT FORM IS: DUMPD UUU CC HH R 
OR: DUMPD UUU WITH THE CCHHRR ENTERED ON REQUEST 
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No parameters were specified with DUMPD. 


I/O ERROR ON DISK UNIT XXX, 
CSW = xxx . . . XXX, SENSE = xxx . . . XXX 


An I/O error occurred. Check to see if the record address is 
outside the file boundaries. | 


STO CONDITION CODE 1 
SIO ERROR ON DISK UNIT xxx, 
CSW =X 4-4 eg ee; SENSE = Rex ou 6 RRR, 


An invalid device address was specified. 


ERROR IN SPECIFYING RANGE OF BLOCK NUMBERS 
CORRECT FORM IS FIRST LAST OF THE RANGE 


First block number was larger than the second. First parameter 
must be less than the second parameter. 


EXAMPLE: 


dumpd 191 01 02 05 

CC HH RR 

002¢ 

BBB 

03 05 OD 
CC HH RR 

02 02 

CC HH RR 

0020 0022 

BBBB 

cr 


Rs 10.37.11. “T =:0.81/257 
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3.1.23 DUMPF 


Purpose: 


The DUMPF command dumps the contents of all or part of a specified 
file in hettagce at and EBCDIC. 


Format: 
ee Saat damit oe oe fk, = 
| DUMPF | filename filetype | fa frat j=?) (print) | 
| L | & SO; i ty 
PSone aCe ae Le eee eae eee eee a eee ae 


filename filetype specify the file to be cumped. 


ni . » BS the line numberof the. first. dine . 
to be output. 


n2 —~ . . is the line number of the last line to 
be output. 


n3 a * is the maximum number of characters to 
= a be output on a line, if the records are to 
3 a be truncated. | 


print. the output will be sent to the system 
printer. 
Usage: 


The filename and filetype must be specified. If the first line 
number and last line number are omitted, or specified with 
asterisks, the entire file will be output. An asterisk in the 
first line or end line fields specifies the beginning or the end 
of the file, respectively. 


Output lines are truncated to the specified limit, if any, or to 
80 characters. If a limit is specified, the first line number 
and last line number fields must be filled, either explicitly or 
with asterisks. | Agtoene : 


Output appears at the terminal unless the print option is used. 


The search for the file is made on the permanent, temporary, and 
system disks in that order. In the case of files with duplicate 
filename and filetype, only the first file found will be typed 
out. | 
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REMOTE 


3.1.24-1 REMOTE 


Purpose: 


To print or punch CMS files on an OS controlled remote terminal 
(2780/1130). 


Where command = 
Print: 
The specified file will be printed on the remote printer with 
automatic single spacing. | 
Printcc: 
The specified file will be printed on the remote printer with 
the first character of each record interpreted as ASA carriage 
control. ; 
Punch: 
The specified file will be punched on the remote punch. 


Where destination =: 


NY 2780 in New York City-VCS Marketing Office 
BC 2780 in Washington DC-SBC, 


Filename filetype <filemode> 
identify the file to be transferred. 
If filemode is omitted, PL is assumed. 


Notes: 


a. Only fixed length records can be handled 

b. Machine carriage control characters are not valid. 

ce Punched output will be preceeded by an OS header card. This 
should be disregarded. 
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3.1.24-2 REMOTE 


Responses: 


filename filetype filemode NOW SET UP FOR REMOTE "command" IN 
"destination". This indicates normal termination of REMOTE 


Examples: 


a. REMOTE PRINT NY FILE FTO1FOO1. The file FILE FTOLFOO1 Pl 
will be set up for remote printing on the NY 2780. 


b. REMOTE PUNCH DC DATA DAOQ]L P5. The file DATA DAO] P5 will be 
set up for remote punching on the 2780 in Washington, DC. 


‘Error Messages: 


<REMOTED REMOTE FUNCTION NOT VALID Command spree tied was not 
PRINT, PRINTCC, or PUNCH. - 


filename filetype filemode DOES NOT EXIST ON YOUR FILES 
INVALID REMOTE COMMAND 


“Wrong number of arguments specified 
"destination" NOT A VALID LOCATION VALID ONES ARE NY AND DC 


YOU MAY NOT PUNCH filename filetype filemode BECAUSE RECORD 
LENGTH TOO BIG. Punch files must have LRECL = 80 or less. 


THIS FILE CANNOT BE REMOTE. "command" ED 


Record length or other error encountered. 


a 2 


BAD REMOTE MODULE... 


Error was encountered in the REMOTE module. Contact 
your marketing support representative. 
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.2.C  EXECUTICN CONTROL 


Several ccnrmands are available te the user fer execution centrol, 
ie€. the leading and running of programs. Files (or programs) which 
are to ke loadec and rur under CNS must reside on disk and rust be in 
€ithec relec¢atatle cbhject ccde fern cr inccre~image form. A progran 
ir relcecatable chject ccde form is one whose address references can he 
moéified te ccmrpcnsate fcr the relcecation which cccurs when the 
fleyrim is loaded into core. A program in Core-~image form is cne which 
repcesents a ccyy cf the ccntents c£ core which would be executable, 
All ct its address references have teen resolved and it can'no longer 
ke célocated. 


Cutput frer the assembler and all cecrpilercs 
aS relccatable object ccde, Unless an 
specified by the user, this output will 

user's permanent disk, and will be assigned a Filetype of TEXT. All 
files whcse filetype is TEXT are assumed tc consist af relocatable 
ckject cede ané are frecessed acccrdingly. To load such files into 
ccora, €ither the LCAD, USE, or REUSE Commands may te used.. The LOAD 
comand will reed the specified file(s) frem disk and load them iuto 
ccre, relccating the programs, and establishing the preper linkages 


supported under CMS 
opticn to the contrary is 
ke created as a file cn the 


tetseen program segrents. Several cpticns may be specified in the 
LCAL command t&hich allow the vser to specify text libraries te he 
sei;irched for wissing subroutines, te request that execution of the 


leaded pregran(s) begin, etc. USE andyor REUSE should te issucd only 
after a LCAD ccnomwand has been issued. The purpose of the USE ccmmand 
ig tc lead the specified TEXT file(s) inte core and to establish 
Jirkages hkeltwcer these programs anc previously lcaded programs, The 
REVIE cconmand ferferms the same function as the USE command but has 
tne additional effect of changing the default entry point cf these 
Programs to that cf the first filename specified in the REUSE ccumand. 

A cove-imace cepy cf any infcrmation currently residing in core 


_way be created ty issuing the GENMOD commnand. This comnand will 
create a file cn the user's perranent disk which is a copy of the 
ccortents cf ccre between the specified locaticns, and will assign a 


filetype cf MCELLE to this file. All files whose 
are assumed tc be in ccere~image form and are 
Tc load such files. inte ccre, the ILGADMOD ccmmand is used. Since 
adjiress references do not have to te resolved, the LCADMGD yrocess is 
_fastec than the LCAL yrecess for a given progran. 


filetyre is MODULE 
processed acccrdingly. 


Arter files have keen loaded into core ry either the LOAD, USE, 
BEFOSE oc LOADMCE ccmmands, executicn may be begun by issuing the START 
cemgand. Execution may also he initiated ty specifying the XEC cprtion 
with LOAL. 


The £¢ cennand is used: tc lead and start a specified file, 
cepenjJing en its filetype, as fcellcws: (1) if a filetype of EXEC is 
tcurnd, the file will ke agsumed to consist of one ox more CMS cemmands 
and the EXEC ccamand will be called tc execute these ccmmands; (2) if 
a filetype cf PCDULE is found, the LCACMOL ccmmand will. ke called to 
loid the tile irte cere and then the START ccmmand will be called to 
tegin executicr; cr (3) if a TEXT filetype is found, the file willbe 
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lealed into core by a LCAD command and then START will he called tc 
bkegin executicn. . 
io, 


a 


-the functicn 
dlittarics: (1) 


cf the GLCEAL command is to specify twe types cf 
litraries ccntaining TEXT files which are to be 
eeatched by the LOAD, USE, or REUSE commandS for MisSing sSubrottines 
and undefined names, and (2) likraries containing macre definiticns 
which are to ke searched Ey the agsenmbler fcr resolving undefined 
tacrcs. If the GLOBAL command is used, it should be issued prior to 
the LCAL, USE, KEUSE, or ASSEMBLE cecmmands to which it refers. 


‘ : ' 05/01, - 
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jeZ.1) GENMOL MEE Seed? 
| Wee | 23l PSP 
ae ‘ Before the ccre-image file is written out, 411 undefined syrbols 
EULEOSES are defined te lccaticn zere and common is initialized. 
Ihe GENMCD command, is ved to generate non-relocatatle core-image hetes;s 
files. ‘ ; 
ae Any files existing on the permanent disk with a filetyre of 
Fernat: module and the sare filenane as that specified in the GENNCD 
conmand will be erased before the new file is created hy the 
CENNCD ccnnand. 
: i { . 
{ GENMOL | entry] <entry2> (NOMAP) | t. To lcac¢ inte ccre any files which have heen created by the 
. t G ] N ] GEKECD command, the LCADMGD command should be used. 


a ee 


. ; Ce The FCDULE file will contain 4 load map of the core-isage 
entry i is ar entry fcint cr a contrel secticn nane unless (NCMAEF) is specified. 
incating the starting core location fror - 
which the core-inage ccry is tc be generated. : . 


Tt will also ke the filenare assigned to the d. A MOLULE file withcut a lcad map nermally reguires less disk 
pewly generated file. space. 
“pe entry z is an entry peint cr a contrel section name Acsponses: 
: indicating the ending core lecation fren © ( 
which the ccre~inaqe cory is tc be generated. 
None. 
(NOMAP) specifies that a_lcad map is net to be 
contained in the core-image file. Exaugles: 
Usage: . Ae GNEMCE FIRST 
' Assuring that a file which centains an entry point FIRST has been 
loaded inte core prior te issuing this ccmmand, the above example 
The GEAECD command will cause a file te he created which is a wculd cause a core-image file to he created cn the user's 
copy of the ccntents cf a specified perticn of core. Normally, permanent disk. This file would consist of the contents of core 
-! the LGAD, CSE, or REUSE commands will have teen issued prior to frem entry point FIRST to the next availakle load iccation and a 
‘the GENMCEL ccmmand, tc lcad inte core the file or files of which loac map ard it weuld have an identifier of FIRST MOLCULE Pi. 
a ncn~relccatatle core~image copy is to te created. The newly 
created file will ke placed cn the user‘s permanent disk and will ' 
-: be assigned’ a filename of the first cperand specified in’ the be GENNOL ABC DEF (NOMAP) . 
7 GEXECD ccnnand, a filetype cf MODULE, and a filemode cf Pt. this exarple would create a file on the user's permanent disk. 
_ with a filename cf ABC, a filetype of MCDULE, and a filemode of 
: P11. the file will be a cory of the contents of core fror entry 
Yhis file will ke in ccre-inage feorm and will te a copy of the point ABC to entry pcint DEF and a lcad map will not be includea 
eccrntents cf core from the first entry fFcoint to the second entry " jn the MCEULE file. 


feint specified in the GENNCD command. If cnly one entry feint 
if specified, the ccre- image file will ccnsist of a copy of the 
Fs contents cf core from the first entry point specified to the next Frict MNcgesages: 
= availaktle lead Jlecaticn. (The next available load location is ( 
indicated ty a pointer which is updated after each LOAD, LOADMOD, 
USE, or REUSE ccomand is issued.) E(cccct) NO “entry1" MOLULE 
This messaye indicates that the entry point(s) specified 
- cannct be located in core. Check to see that these entry —---7 





| 
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3.2.2 GLOBAL | a Ais: 
AIS 


E£urgcse: 


GLOBAL specities either (1) macro definition libraries to he 
svarched during the ASSEMBLE ccrmand er (2) text libraries ; : 2 
to be searched when loading files containing relecatable object code. 


format: 
] } ASSEMBLER KACLIB ; i 
} GLCBAL J] (¥) <liknamet...liknameNn>| 
J }. LOACER TXTLIB : . i 
t 1 (T) a ott be to | 


ASSENELER MACLIE specities the library files that are 
: (h): to be searched for macro definiticns 
during subseqient assemblies. 


LCALER TX1LIB specifies the likrary files that are tc 

(T} te searched fcr missing subroutines 
during subsequent LCAL, USE, or REUSE 
crperaticns. 


-Litnanel..elitnameN specifies the library files whose filetype 
is cither MACLIB or TXTLIB. 


fez 
ttn 
iw 
ira 
Im 

os 


GLCBAL has twe ferrs--~the ASSEMBLER form and the LCADER form. 


<ERBLER Forme The ASSEMBLER fcrm of the GLOBAL conmand allows ; 
iegerrrecve cert the macre libraries to be used during the executics 
of the ASSEVRLE command. Cne to five macro libraries may he specifie * 
These macrc libraries will te searched fcr macro definitions in the 
coder in which they are named. 1f the system macre likrary SY¥SLIB 
FACLIB ig te te searched alcng with the user's hacre library, SYSLIB 
must be specified as one of the five likraries. . 


ibr sifi é j MACLIAB. For a 
Each mactc libraly specified must have a filetype cf 
descripticr of MACLIF files and how to generate them, sce the MACLITB 
ccamand ({Secticn 3.1.1C). 


Unless a previcus GLOBAL ccormand has been issued, the ASSEMBLE command 


4 


(AIL FS? 95/01/89 
will search cnly one macro library: SYSIIE MACLIB. This file resides 
cn the CME system disk and contains many nacro definiticns of cosnon 
use to C¥S users. If the user has created a file named SYSLIB MACLIP 
that resides on either his perranent cr tempcrary disk, it will be used 
an place cf the system file, since ASSEMELE scarches first the perranent 
disk, then the tewrperary disk, and finally the system disk for the 
specified Jikrary file. 

Tc terminate the searching cf all macro libraries, including SYSLIE 
MACLIB, the GLCRAL ASSEFELE& command can be issued with no liknanes 
specified. 


One the ASSFMBLER ferm of the GLOBAL ccmmand has been issued, the 
specified nacre libraries are searched for macro definitions 
Guring eack assenkly until either 

(1) a GLOBAL ASSEMELER coumand is re-issued, or 


(2) the CMS nucleus is re-initialized, or 


(3) the user legs cut from CF. 


FoL a further discussion of macro libraries, refer tc Section 6.4.9. 


ICADER_ The LCACEF form of the GLOEFAL command allews the user to 
specify text libraries te te searched fer missing subroutines vhenever 

the LCAD, USF, or REUSE commands are issued. One to four text Libraries 
way ke specified. These text litraries will be searched in the order in 
which they are named. If the system text likrary SYSLIB TYTLIB is to 

be searcheé aleng with the user's text libraries, SYSLIB must be specified 
as cne of the four lihraries, 


Fach text Jitrary specified must have a filetype of TXTLIB. Fora 
descripticr cf TXTLIB files and how to gencrate them, see the TXTLIB 
comand. (Section 3.1.16). 


Witheut the vse of GLIOEAL, the LOAD, USE, and REUSE ccomrrands seatch only 
the text Jikrary SYSLIB TXTLIS8. This file resides on the CMS 

system digk and contains many Subroutines cf use to the CMS user. 

If the user has created a file with the identifier SYSLIB TXTLIB 

that resides cr either his fermanent or tenperary dick, it will he 

used in pflace of the system file, as the loading process searches 

first the user"s permanent disk, then his temporary disk, and finally 
the syster disk for a specified library file. 


If the GLCEAI LCADEF command has been issued and the user wishes to 
eliminate the searching of the frevicusly specified text libraries, 
the command GLOBAL LCADER TXTLIB can te issued specifying no libnames. 
This will terminate all liksary search fer the missing subroutines 
when files are loaded by the LOCAL, USE, or REUSE commands. ; 


Cnce the LCALER form of the GLCBAL cormand has been issued, the 
specified TXILIB riles will he automatically searched fer nissing 
sukErcutinés during each LOAD, USE, cr REUSE until either 
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(1) a GLOEAL LOACER ccmmand is re-issued, or oF 4 AEB 
{Z) the cfpticn LIBE is sfecified with LOAD which overrides 


the GICBAL LCADER command for the duraticn of that 
LOAL and any USE cr REUSE ceonmands which follow 
that LOAL, cr 

(3) the CMS nucleus is re~initialized, or 


(4) the user lcgs cut of CP. 


Fot further discussion on text libraries, refer to Section €.4.0. 


. 


Verges: 


a. Jt the GLOBAL ASSEMBLER ccmmand is issued, one to five macro 
latraries say be specified and each must have a filetype of MACLIN. 


t. If the GLOBAL LCAFER command is issued, one to four text 
litrcaries say bé Specified. and each must have a filetype of TXTLIB. 


s 


ce GLCBAL will verity the existence of the libraries. 


If a library 
jJees not €xist, an €rrcre message will be generated. 


de “"ASSEPELER MACLIE" and "LOATERK TXTLIE" may ke akbreviated by 
"a" and "I", respectively. 


1 


de - GILCEAL ASSEMELER MACLIB NEWLIB KYMAC 

The likrarics NEWLIB MACLIE and MYMAC MACLIA will be searched for macro 
detiniticrns during the ASSEMBLE. ccmmand. TThe order of search : 
for racro detiniticns will be NEWLIB MACLIPB and then MYMAC MACLIB. The 
system macre library SYSLIE MACLIEB will not te searched. 


bk. GICEAL ASSEFELEFR MACLIE 

Inis exanple cancels tke effect cf any previously issued ASSFMBLER 
tert of the GLCBAL command and causes no library tc te searched for 
macro defjriticns during executicn of the ASSEMBLE command. 


Cc. GLCEAL LGADER TXILIB SCCOF OPS SYSLIB 
The libraries SCUOP TXILIB, OPS TXTLIB will be searched for missing 
subroutines during the LOCAL, USE, and REUSE commands. The crder of 


~—- t 











search fcr missing suhroutines will be SCOOP TXTLIB, OPS TXTLIB, 
and SYSLIE.TXTLIB. : . 


d. GLCEAL LOADER TXILIB ‘ : 

this exanple cancels the effect of any previcusly issued GLOBAL LOADER 
commané an€ causes ne library to be searched fcr missing subroutifies 
by subsequent LOAD, USE, or REUSE commands. 


Error Messaces: 


£ (C0001) An invalid ferm cf the GLOBAL ccmmand was issued. 
ke-issue the command in its ccrrect format. 
E (00002) TOQ MANY TXTLIBE (max=4) OR MACIIES (max=5)  _ 
SELCIFIEL. Re-issue the GLOEAL ccmmand reducing 
the numker cf libraries specifiei. 
F(CC00 3) "Vitname" LIBRARY DCES NOT EXIST. 


Existence of "liktname® NACLIB cr "libnape" 
TXTLIE hag not been verified; "Litname" : : 
has been cmitted frem the active list.of libraries. 
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3.2.3 LOAL _ oe Suke suptress the print cf Replace card images in the file LOAD MAP. 
KD, . TEP print Replace card images in the file LOAD MAE. 
Purpose: eee ; ee 
= LIRE search cnly the specified TXTLIB files for missing subroutines. 
eae SYSLIB search the SYSLIE TXILIB file for missing subrcutines; oF, 
LCAD reads from disk one or more TEXT files - containing if the GLCEAL LCADEK command was previously issued, search 
relccatatle chiect ccde - and loads then into core, establishing - tte libraries that were specified in the GLOEAL command 
the proper linkages between the files. Corrections or additions list. 


cap be made at load tine and the user can specify librarics to he 
searched fcr missing sutroutines. The user can also specify that 


execution shculd begin uyon successful ccmpletion of loading. XE" execute the loaded files, 
a "— NOXEC dc rot execute the leaded files. 
Fetgat: 
Peete USAges 
ct ay : ; { The TEXT files specified in the LOAD ccmmand must consist of 
{lCjc] filenasel...filenamen <{optiont.,.opticnn libname1...litnamen>| relecatable ohject code, such as that produced by the ASSEMBLE, 
\ | $ : FORTEAN, cr PLyI ccmmdnds. ° 
Since LOAL assumes the NOCLEAR cfticn as a default, the files 
Lilename..-fLilenaneNn specify the names cf TEXT files that are heing leaded will not be placed in zereed core. To zero 
: to be loaded into core. core kefere the files are loaded, the option CLEAR must be 
: ( specified. , 
crticnl.esceticnn specify the options tc be in 
etfect during loading. 
ICAL autcnatically begins Ilcading the specified files into core 
dibnane1...liknamey specify the names of TXTITB files at hexadecimal location 12000. . This load point may he changed by 
to te seafched for missing specifying the cpticn SLCxxxxx, where xxxxx is the hexadecinal 
subroutines during lcading. locaticn at which loading is to begin. The SLCxxxxx ception may 
’ not appear as the first ception in a string unless it is preceded 
, Ey cne or fore blanks. 
Crticns: 
Unless the NOMAF option has teen specified, a load map will ke 
CLEAR zere the load area before loading. ; created cr the fernanent disk each time the LOAD ccrmand is 
KCCLEAE dc net zero the lead area befcre loading. issucd. A load map is a file that ccntains the location of 
ieee $s os cenire] sections and entry points of the files loaded inte ccre. 
: It may alse centain certain messages and card images cf any 
SLOxXxxxX Legin loading the pfreqram at hexacecimal locaticr XXXXKXK. invalid cards or keplace cards that exist in the Ilcaded files, 
eLc1z¢C tecin lcading the pregqram at hexadecimal location 12000. . Tunis load map will nermally he created as a file with the 
saa at identifier LCAL MAP £5. Cnly one such file may exist on the 
pernanent Gisk. Fach tire LOAD is issued, a new LOAD MAF will : 
NCMAE ac not create the file LCAD MAP. replace any previcus LCAD MAP tile that exists. To prevent a 
PAE create the file LCAD MAP. ; LOAE MAP file frem Leing created, the option NCUAE must he 
aie : epecificd then the LCAC command is issued. 
TYEE types tke file LCAD MAP crline.e | 7 
DCIYEE dc rot type the file LCAC MAP online. Since [CAL assumes a default of NOTYPF, the LCAD MAE file. is not. 


; autcmatically typed cut unless cpticn TYPE is specified when LOAD 
: ; “is issued. See FIGURE 3.Z2.3~A. The LCAN KAE file may also be 
SINYV suppress the printing cf invalid cari images in the file LOAD MAP ““ printed ott by using the PRINTE or OFFLINE PRINT cornand. 
ElbV prirt invalid card images in the file LOAL MAP. 


If invalid card images exist in the file cr files that are being 





loaded, they 
the LCAL EFAE 
images .in the 


. From one 
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will be listed with the message "INVALID CARD" 10 Ei 
file. Te suppress the listing of invalid cara’%’”” 


LOAD BAP, the option SINV must be specified. 


load w (type) 

W AT 1200C 

W AT 12000 
IHCFCOMH AT 12748 
SAVARFA AT 1374C 

IBCOM AT 121748 
FDIOCCS AT 12204 
IHCFCVTH AT 13198 

ADCCK AT 13198 

FCVEO AT 13BBA 

FCVLO © AT 13412 

FCV1O AT 1372C 

« FCVCC AT 13DE4 ‘ 

FCVAOQ AT 1336A 

FCVZC AT 132E4 
IHCFIOSH AT 14188 Pe he 
FICCS AT 1418€ 
IHCUATEL AT T4p7C 


THE FCLLCWING NAMES ARE UNTEFINED: 
SUEB1 


E (00004); T=2.33 


FIGURE 3.2.3-A. 


(FEF) card images exist in the files 
they will he included in the LOAL 
MAP. To suppress this listing of REP card images, 
the option SRFP must ke specified. Fer an 
explanaticn cf REP card images see Section 5.3.9. 


If Feplace 
keing leaded, 


Unless the GLOBAL LCADER 
LGAC searches anly 


cemmand has been issued, 
the system text litrvary fer 
sulroutines that are missing from the files being 
loaded. The system text litrary is the file that 
ccntains TEXT files and has a filetype of TXTLIB. 
to four text Jlikraries can ke searched 
during lcadirg by the user having previously 
issued the LCADER form of the GLOBAL ccrmand. If 
the system text library is to be searched in 
addition to the text likraries specified with the 
GLOBAL LCADER ccrrand, SYSLIB must ke included as 
one of the text libraries in the GLOBAL LCADER 
ccnnand. See the description of the GLCBAL 
comnand for the specific details. 


If a file has teen created on the fermanent or 





AY 


Typecut cf the LCAD MAP file during the LOAT 





Ix 


ter 
lo 
in 
ae 


“The 
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NGA 
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se 
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temporary disk with the identifier SYSLIB TXTLI#, 
it will be used in flace of the system text 
library because the order of search for the SYSLIB 
TXTLIE file is first the pernranent disk, then the 
temporary disk, and finally the system disk. 


To prevent LOAD from searching the system text 
library and the files specified by GLOBAL, the 
LIBE cpfticn can he epecified. The LIBE option 
terminates the searching cf all text likraries 
except fcr these specified with the LCAL cemmand. 
If SYSLIE TXTLIE is to ke searched alceng with the 
specified litnanes, SYSLIB wust be included as one 
of the libnames. The crder of search of -the 
specified litnanes is the crder in which they are 
Names and they must have TXTLIB filetypes. If the 
LIBF cpticn is issved andnc TXTIIB files are 
specified, no TXTLIB files will he searched for 
missing subreutines-~net even SYSLIB TXTLIR. For 
a discussicn of text library usage, refer te 
Secticn 5.4.C€. wet 


Since LOAL assures KCXEC as a default cption, LOAD 
does not normally Fegin execution cf the lcaded 
files. To cause execution toe begin inmediately 
urcon successful corpletion cf loading, the option 
XEQ can be specified. LOAD will then transfer 
contre] te the default entry point in the progran. 
The default entry point is cither (1) the addross 
as specified in the operand field of the first END 
card image containing a neon-bElank operand field or 
(2) the keginning cf the first file loaded if all 
END card images in the TEXT files ccntained blank 
cperand fields. In the case cf TEXT files that 
are created Ey FORTRAN, contrcl will te passed te 
the first main ,rcegram leaded. If the XEC option 
is not specified, the START cemmand must be issued 
tc beyin jregram executicn. 


LOAD allews 
images in 


the user tc include the follcwing card 

the TEXT files alcng with the 
relecataLle chject code: the Set Locaticn Counter 
(SLC) card image, the Replace (REP) card image, 
and the Include Ccntrol Section (ICS) card imaqe. 
S1C card image sfecifies the hexadecimal 
lecaticn at shich files are te be loaded. The REP 
card image specifies ccrrecticns to he made to the 
relocatatle object code. The ICS card imaqe 
specifies additicns to be nade te the TEXT file. 
For a description of these card images and their 
ase and placerent in a TEXT file, refer to Section 
5. 3,0. 
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1. The filenames specified must have TEXT filetypes; the 
libnares mist have TXTLIB filetypes. 
ke. dif the 118E option is specified and the system text library 
is to ke searched, SYSLIF must be specified as one of the 


dikrames. 


c. To téeruinate the searching of all test libraries, including 
SYSLIB, specify the 11BE opticn ard de net specify any libknanes. 


EXFCUTICN BEGINS... : 
Ine XEC cption was specified with the LOAD command and the lJcaded 
Eregram hag teaqun execution. Any further responses will be from 
the Pregrame | 7 


Ale 7 


IRVALID CABD - 
Ihe PINV cyticn was specified with LOAL and an 
kecn found. The pesraye and the contents cf 
(xxxXeeexx%) are listed in the file LCAD FAr. 
iyncred ané Jcading centinvues. 


XXX oan XXXe 

invalid card has 
the invalid card 
The invalid card is 


CONTECL CARD —- aee . 
A lcader cx library-search control, card was enccuntered; e.g., 
geNTbY, TLILEFARY. : 
It the TYEE option is specified with the LOAD command, the LOAD 


mae file will te typed cut (see FIGURE 3,2.3-A). 


Exaiples: 


Be LCAL MAIN SC3 CALCU 

The tiles VAIN TEXT, SC3. TEXT, and CALCU TEXT are Jcaded inte 
core and tke. linkages resclved. If any eubroutines are missing 
and the GLOBAL LGALEk command has not keen previcusly issued, the 
file SYSLI# IXTLIB will te“ searched. If the GLOBAL LCAPER 
command hag been previcusly issued, the liknames specified in 
that ccemmerd will te searched. ‘The fellcwing default options are 


cet: SCCLEAK, NGTYEF, SLC12000, PINV, PREP, MAP, SYSLIB, and 
hOXEC. 

e LCAL BPS67 HOCK (XEC TYEE CLEAR) . 

the files MESH? TEXT and PCCK TEXT are loaded inte ccre and the 


linkagec reeclyvecd. Ccre ig zerced before loading takes place and 
the LCAD PAE file is typed out. Upon the successful completion 
cl loading MESC7 and HOOK, the leaded files will begin execution. 


5 es ag sy te ctinnca meio shoe ie eh ered as conctone SOs, des aaa ataat Sema Gk ese ee 8 a Sat ee gh ad alinge wo 
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lf LOE aed 


Ce LCOAL MASS WRATZIZ 
Ihe files 


(LIBE) SSP MYLIE SYSLIB 
MASS TEXT and WHATZIT TEXT are leaded inte cere and the 


linkages resclved. If any svbrovtines are missing, the following 
litnames will be searched in the order in which they are 
specified; SSP TXTLIB, MWYLIB IXTLIB, and SYSLIB TXTLIB. The 
retaining cpticns are set to the default oyticns,. 

1. LCAL MASSEFEC (LIEE) ; 

The £i1¢ FASSERC TEXT is lcaded into core and the linkages 


resclved. If any subroutines are missing, ne text likraries will 
te searcheé, since the LIBE crtion wag specified without giving 
any liknameées anid an error cede will ke returned. 


Ereor_Messaces: + 


£ (00001) DEFINED MCRE THAN ONCE~xxXXXx¥RXXX 
The name xxxxxxxx has been ‘defined sore than once. Check 
the tiles that have keen loaded for either duplicate entry 
pcint names of duplicate ccentrcl section names. Loading has 
been cerpleted,. 


E(COCO2) -CVEELAY EWG 


The files téing lcadecd have run cut cf core, Specify fewer 


files cr reduce the size of the files. Loading has been 
ccnpletod, 

£40003) REFERENCE TALLE CVEEFLOW F 
There are tcc wany entries for entry fpeints on control 


secticn names ‘in the reference tatle that is built during 
loading. Lcading has heer ccmpleted. Reduce the number of 
entry points and control sections in the files. 


E(COGO4) THE POLLCRING NAMES ARE UNCERINFD-xxxxxxxXx 
The némes XxXxxxxxx are referenced in a file and 
dcrined. If the names are defined in ancther 


are never 
subroutine, 


issue the USE ccmmand for that file. Loading has been 
ccmpleteds 

E(CCCCE) FILE NOT FOUND=xxxxxXxxx 
A tile with a filename of xxxxxxxx dees not exist with a 


filetype cf TEXT. 


Dynamic Loading 


Eyring program execution, ancther "relecatatle object 
deck" = ray be kreught inte cere, external] references 
resolved, and centrel given tcit -- that is dynamic 


z ; : : atte 
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leading. The desired routine must exist cn the user's files 
with a filetype cf TEXT, (2) or exist in one of the 


The routine 
also be loaded 


with filetype of TXTLIB, 
cr library routines to 


desigrated libraries 
may cause other TEXT 
intc core. 


Three CHSyOS macroes may be used to initiate dynamic 
loading: 
LCAD (SVC 8) — will cause the object deck ccntaining 


the specified entry point to be brought 
into core and the entry point address 
tc be returned in register zero (0). 


will call in and transfer ccntrol 
to the specified entry point. 


LINK (SVC 6) - 


will delete the "calling" routine, then 
the specified routine will be brcught 
in and given centrol. 


~XCIL (SVC 7) - 


- RETURN (XVC 3) used to DELETE (SVC 9) 
the "called" routine and gives centrol 


back to the "caller". 


: 
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3.2.4 LCADNCD ae 
ALG 
Purpese3 


Tbe ICGADKCD ccrnand lcads intc care any Single file which is in 


nonrelccatable core inage fers. 


Format: 
{| LCAEMCL | filenase <filerode>} 
j ICADF 1 1 
filenare is the name of tke file te be lcaded into core, 
. whese filetype oust be FODULE. 
filerode is the mcde cf the KGNULE file to be loaded. 
Usage: 


ICADMOL is used tc Ilcad a file wuhich kas bcen created by the 
CENNCD command. The £ilecaxe cf the file to be leaded is 
epecified as the operand of the LCADMOL command, and its filetype 
must be NOLULE. 


when the ICALECD command is issued withctt specifying a filencde, 
the user's permanent ané tenperary file directorics and the 
eystem file directory ar¢ searched, in that cxrder, for a file 
with the specified filenace and a filetype of UMOLULE. If a 
filenode is given, only that disk is searched for the MCDULE 
file. If such a file is fcund, it will be assuned tc he in 
noh~relccatable ccre-isage fcrs, and will te loaded into ccre. 


Resporses; 
Kone. 
Examples 
ae LCAIMOD FILE1 
fhe file whcse filerame iS FILE! will be loaded intc core, 
Frovided it has a filetype cf MOLULE. If it does not, an errer 





pessage Will ke returned, and the lcading process will not take 


Flace. 
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Error Messages; ALF 
§ (0000 1) FILE CCES KOT EXIE1, 


DISK ERROR. 
Either cf the abcve nescages indicates that a file with the 
specified filenase and a filetype of MODULE cannot be 
lccated in the wser*s permanent or temporary file 
directcries or in the systen file directory. Check to see 
* that such a file exists and that the filenare specified in 
the ICALHCD conmand is identical tc the filenane of the file 
tc te lcaded. : 


E(cecc2) DISK ERROF. : 
An address has keen gé€nerated cutside the Eounds of core 
storage assigned tc the user. Attempt to re-issue the 
Ccppand. 


€ 


E(CCC03) LISK ERROR. "a 
A disk salfuncticn has occurred. Re-issue the LOADNOD 
ccempand. If the tessage persists, a disk hardware prcblen 
has yrekakly been enccuntered. 


E(COCCA) FILE DOES NOT, EXIST 
DISK EBECE. 
Either cf the ahcve messages indicates that the filemode of 
the specified file dces not kegin sith P, Tt, or S.° Change 
the. filemode tc a valid cne, if necessary, and ré-issue the 
ccerand. ‘ ; 


E(CCCCE), DISK ERNOK. 
Either ccre space assigned tc the user is not large enough 
fcr, leading the specified file or the syster has attenrpted 
tc clese the file price tc opening it. Re-issue the LOALNOD 


ccnmmand. 

E(CCO007). [ISK ERROR. 
Tke specified file carnct ke read from disk, Re-issue the 
LCALNOD command, If this wessage persists, the file has 


Frokably been written cut inccrrectly, and shculd he 
re-created using the GENKCD command. 


F (00009) LISK ERROR. 
The specified file is cpen for writing and cannct Currently 
ke read. Re-issvue the ILCADFCD command. 


E(CO01C) PISK ERROR. 
Eight files are alreedy cpen, and the specified file cannot 
ke cpered. Issve a FINIS command, and then re-issue the 
LCALCHOD ccrnmand. : : 


‘ oe 
05/01,09 
points exist and re~issve the command. Alf 3.2.4 -3 
: CCE 

3 (C0002) DISK ERROR, 

; An adéress has been generated outside the bounds cf core. 
storace asSigned ta the. user. Attempt to re-issue the 
ccumand, : 

E (00003) DISK EBFOR. 


A disk palfuncticn bas cccurred. ~°Re-issue the GENNOD 
ccmmard, If the message persists, a disk hardware protien 
has prokably been encountered. 


“E(CCCCA) “DISK FRROR, 


An atterpt te close the file after writing it cut has not 
been successful. Issue a FINIS and then re-issue the GENMOS 
command. OS 


. 


E(COU05) DISK ERFOR,. ee 
An illegal seccnd character” has been encountered for 
filencde. Re-issue the GENMCD command. 


E(COO00E) DISK EBECKH. 
The system has attempted te clcse the file prior to opening 
it. Re-issue the GENMCD commana. 


F(CC010) ° DISK EBFOR, 
Eight files are already crpened, and the command cannot he 
exectted, TSsue a FINIS ccmmand and then re-issue the GENMOD 


command. 
E(CC013) DISK ERRCK. 
The user's disk is full, and the ccre-imaqe file cannot be 


created, Erase cne or more of the unneeded files and 
re-issue the CENKCND command. 


3.2.6 &kUSE ae 
Af 7 

EucEese: 
BEUSE reads from disk cre cr more TEXY files -- containing 
Ielccatakle object code’-- and loads ther into core, eStahlishing 
linkages with previously loaded files, and changing the default 
entry point cf these tiles te that of the first file specificd in 
the REUSE command. 

Focmat: 

I 1 . ’ ; 

JREUSE jfilenanet...filenanen (cpeticni...cpticnn) <libnamel...libnamen> 


ee ee! ee 


specity the names of TEXT files 


filenarel....filenanen 
. : to be lcaded inte ccre. 


specify the cpticons to be in 
effect during loading. 


ortiontl.e.cpticnn 


specify the names of IXTLIS files 
tc ke searched for missing reutines 
during loading. ; 


Jitnamet..litnaren 


’ 


Ceticrs: 


Ihe cpticne that may be specified with REUSE are the same as 
these with LCAL. fefer to Section 3.2.3. 


Usige: 
REUSF @oes not overlay any file that was previously Ilcaded by 3 
LUAE, USE, oc REUSE ccrmand. It leads the specified files intc 
higher ccre from the point of which tke frevicus LOAD, USE, o1 
REUSE ccuosand terminated Ilcading. KEUSE ferforms the same 


functicn as USE except that REUSE changes the default entry peint 
to that cf the first file specified with REUSE. 


The specificd tiles are recvired to have Filetypes of TEXT an¢ 


snculd ccntain relccatatle ckject code, 





ASO 


‘specified with the previous LOAD, USE, or REUSE 
ccomand, a1] the cpticns renain set for REFUSE unless each option 
is specified when REUSE ais issued. The LCAD NAP files is 
yutomatically updated to reflect the files being loaded by REUSE. 
Keter to Secticn 3.2.3 fer a descrifzticn cf the LOAD options and 
the LOCAL MAP file. 


If cytiong xere 


INVALID CARD - xxxeeeXXXe 
The FINV crtion was specificd with the previous LCAL command and 
2n invalid card has keen found. The message and the ccntents of 
the invali¢ card (xxxe..xxx) are listed in the file LCAE MAP. The 
invalid caid 1s ignored and loading continues, 


CCNIBCL CARL 
A lcadcr cr litrary-seurch control card was encountered. 
loading 1é€sumes. : 


Nerral 


with BEUSE cr was nct reset fron 
command, the updated fertion of 
out prior to the ccrpletion of 


Ir the 1YEE cpticn was specified 
the previcts LCAD, USE, or REUSE 
the LCAD MAP file will ke typed 
tne BEUSF ccnmand. 


, 


Exaggle: 


REUSE KEALIT GAMMA 


4. 
Ihe 1Ex1 files cf RFALIT and GANMA will tke loaded inte core, 
linkages vill be resclved with the files previcusly lcaded, and 


the dafault entry point will be 


changed to the first entry point 
in REALII. 


Fiicr_fessagcs: 


E (C000 1) DEFINED MCRE THAN CKCE ~- xxxxxxxx 
The nawe bas keen defined mere thar cnce. Check the files 
that Fave keen lcaded fcr either duplicate entry point names 
cr duplicate control section nanes. Lcading has been 
cerplicted. 


F(00007) OVERLAY ENRCK 
The files being loaded have run 
files cr reduce the size cf the 
conpletea. 


eut cf ccre. Specify fewer 
files. Loading has been 


#(CCCC3) REFERENCE TABLE GVEKLAY 
There are toc many entries for entry: points cr centrol 
secticn names in the reference table that is built during 


05 
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loadi Loading has t leted. Reduce th cd hap | | torre 
oadirg. oading has teen cemeleted. Reduce the number of yee, ; a Ma pee ay 
entry points or control sections in the ffiles. oe gab START AS 2 ALES 

R{CCCOM) THE FCLIGWING NAMES ABE UNDEFINED - xxxxxxxx Er 1gse@2 


The pares xxxxxxxx are referenced in a file and are never 

defined... If the names are detined in another file, issue ; ; 

the USE ¢cemmand for that file. Loading has been ccnpleted,. START bheyins execution cf programs previously loaded and passes 
the addregs cf a string cf user agruments to that program.. 


£E(CCC0S) NAME IS UNDEFINFEE — XxXxxxxxx 
The rame xxXxxxxXx specified as an entry _foint does not Format: 
exist. Lcadirg has keen cempleted. Check the name and sea 
if an entcy point or a control section exists hy that name 
in the leaded files. 


[ START | <ertry argumentt...-argumentN| 


EF (CCCC6) FILE NOT FOUND — xxxxxxXxX : l I oan fl 
A file with a filename of xxxxxxxx does not exist with a ; SP ESA eerie Sores TS a a es aa Se 
filetypercf TEXT. . ; * 


entry specifies the name of @ Control section 
- ex entry peint te which ccntrél will he 
passed at execution time. 


argument ?o..argumentn 
‘specify informraticn tc he pagsed tec the 
’ eee | etarted program. ; 


fez 
ttn 
im 
kK 
in, 
ee 


STAT becins executicn at one of two entry points. If the 
' : "entry" operand is specified, execution begins at that peint in 
the pregran. If “entry" ds net specified, execution keqins at the 
dufault entry foint. The default entry point is either {1) the 
address ag specitied in the operand field of the first END card 
image centeining a nen-blank cfperand field cr (2) the heginning 
ct the tiret file loaded if al] END card images in the TExT files 
contained klank cperand fields. The default entry peint can be 
changed ‘ty issuing the REUSE ccrmand toa continue loading 
aadditicna] files. &efer to FEUSE in Secticn 3,2.5. 


Auy undefined names or references that are specified in the files 
loaded intc cere will ke defined te lecation zero. Thus, if 
there is a call or -ranch to a subroutine fren a main program dn 
the sukrcutine was never leaded, the call cr branch = would 
trans£er centrol to location zero at execution time. 


. It arguments are gpecified with START, they are passed to the 
La precuan via gereral fupese register 1. The “entry" operand and 
any alguments are set up in a parameter that as a string of 
words, cn argument per: double word, and the addrese cf the 
parametcr that is placed in qeneral purfese register 1, The 
argurents are accessed with displacements of 8, 16, 24, etc., 


recmerecamenemtcnammeeamamcamn ae Mamie na — Sdn AC AAAS ite hittin tansth nada tid etinieinaasann aanneaidiieabnN GiiaddntinnReR 
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trem the address contained in register 1 when executicn of Gia 2 282 3.2.7 USE GL Yew 
specified pregran kegins,. VO ws 

Furrose: 
USE reads from disk one or more TEXT files -- containing 
¥. "Entry" must Ee either a ccntrel secticn name or an entry celcecatabkle cbhiect ccde -- and lcads then inte cere, establishing 


Ecint rane. It may not ke “a filename if the filenane is not 
ldcntical te either a ccntrel section name or an entry point 
NHAnes 


t. dif user arguments are specified, "entry" must ke specified, 
ctherwise, first arqument will be taken as the entry foint. 


PeSEerses: 


. 


EX:CUITION BEGINS... 
ihe pregran that had keen previously loaded intc cere has bequn 
execution. The reggpenses new 111 be from the pregram that is 
exccuting. 


a. START JNITIL 
Ihe -regran that has already been loaded inte core will begin 
executing at the entry point INITIL. 


be. START FEGOE 13 ALL 109435 m 

The progran that hag already been loaded inte core will begin 
€yccuting et the entry point MEGOP. The three arguments may be 
accessed in the preqram ky using displacenents cf 8, 16, and 24 
toon the atdress ir general purpose register 1. 


F(CcOCOUS) NAME 15 UNDEFINED - xxxxxxxx 

The nave xxxxxxxx specified as the point at which execution is to 
tegin docs net exist as an entry point nare or a control section 
fiam€.s. Fxecution has net begun. Check the name xxxxxxxx and rake 
sure it ig a valid entry point cr centrol section nane. 


linkayes with previously leaded files. 


rr 


iilenamel...filenareNn specify the names of TEXT 
files tc be lcaded intc core. 


specify the cptions to be in 
effect during loading. 


’ 


opticnt...cpticnn 


Jikramel,..-ditnanen specify the nawes of TXTLIB 
tiles te ke searched fer 
tissing routines during loading. 


lev 
Lisl 
tee 
bee: 
in 
i bon J 
tn 


The crpticns that may be specified with USE are the same as those - 
with LOAL. Refer to Section 3.2.3. 


le 
In 
ten 
lo 
In 
oo 


tsk does rot everlay any file that was previously lcaded hy a. 
LOAT, USE,-cr REUSE ccnnand. It leads the specified file(s) into 
higher ccre from the peint at which the rrevicus LOAD, USE, or 
REUSE connand terminated leading. The files specified with USE 
are xreyguired toa have filetypes of TEXT and should ccntain 
relcecatarle ckject cede. 


USE should te preceded ky ICAD; it is nernally issued to resolve 
undefined rames when LCAL gives the follcwing error ressage: 


E(QOCCK) ~ THE FOLLOWING NAMES ARF UNTEFINECDS xxxxxxxXxe 





a ae O., 

Ki : 3 . 2 ‘ a a 2 
USE may te issued repeatedjy tc reseclve linkages and to continne 
leading nere TEXT files. It does not change the default entry 
point estaklished in a previcus LOAD command. 


If cpticns were specified with the Frevicus LOALB, USE, OF REUSE 
ccnsand, all the options remain set for USE unless each option is 
respecitied when USE is issued. The LOAD MAP file is 
autcmatically updated tc reflect the files being loaded by USE. 
Refer to Secticn 3.2.3 for a descripticn cf the LGAD cyticns and 
the IOAL BIE £ile. 


im 
ite 
ten 
Liat 
In 
In 
in 
WD 
ih) 
oe 


INVALIE CARD -— XxXXwooXKX- 
Jno (INV cytions was specified with the previous LOAD coninand an’ 
an invalié card hae been fcund. The message and the contents of 
the invalid card (xxx...xxx) are listed in the file LOAD MAP. 
fhe invalié card is igncred and lcading ccntinues. 


-It the TYEE cption was specified with USE or was net reset fron 
the previcvs LCAD,USK, cr REUSE command, the updated portion of 
the LCAD MEP file will ke typed out prior to the completion of 
the USE cenwand. 


test 
{>< 
Vw 
isa 
he 
ry 
Ic 
ee 


de USE FYTEXS1 CAICA WHKITE6 : 

dic files MYTEXTV TEXT, CAICA TEXT, and KRITES TEXT will he 
loaded inte ecre ard tke linkages will te resclved between these 
three files anid the tiles that have previously heen leaded intc 
core, 


= (C0C01) DEFINED FCRE THAK CKCE - XXXXXXXX 

Ihe name xxxxxxxx has been defined more than cnce. Check the 
files that have teen lcaded fer either duplicate entry point 
nanes or duplicate control section hames. Leading has been 
completed. 


E(oCC02) OVERLAY ERRCR 
The files teing loaded have run out of ccre, Specify fewer files 
cr reduce the size of the files. Loading has been ccrypleted. 


£(CCCC3) EFF FREKCE TABLE CVERFLOW 

There are tco many entries for entry pcints or centre) ececticn 
nance ain the cetercnce table that ig build during loading. 
Leading hag been completed. keduce the hunber of entry pcints or 


a 


ip enmenenarearey ine mente aie oN 
RRR On me RNR Re ae il nirgy RRA the te 


control sections in the tiles. 


. 
« . 
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E¢CcCO4) THE FOLLOWING KAFES ABE UNDEFINED ~ xxxxXxxx 

The names XXXXXXxXxX are referenced in a file and are never 
defined. If the nares are defined in ancther file, issue the USF 
cconmand fcr that file. Loading has been ccmpleted. : 


E(COOOG) FILE NCT FOUND ~ xxxxxxxx 


A file with a tilename cf xxxxxxxx dces not exist with a filetype 


cf TEXT. 


‘The $ command will load and start the specified file, provided its filetype is 
EXEC, MODULE, or TEXT. 


Format: 


filename is the name of a file whose filetype 
must be either EXEC, MODULE, ov TEXT. 


argl... argN are one or more user argumeits. 
Usage: 


The $ command is used to load and start a program. The program niust exist 

as a file on the user's permanent or temporary disk or on the systein disk, and its 
filename must be specified as the first operand of the $ cormmand. When this com- 
mand js issued, the user's permanent file directory will be scarched for a file 
with the specified filename and a filetype of either EXNC, MODULE, or TEXT, 

in that order. If the file is not found in the user's permaucnt file directory, his 
temporary file directory and finally the system file directory will be searched. 


If an EXEC filetype is found for the filename, the file will be assumed to consist of 
one or more CMS commands, and the EXEC command will be callcd to execute this 
file. If no EXEC filctype exists, but a filetype of MODULE is found, the LOADMOD 
command will be called by § to load the program into core and then the START 
cominand will be called to begin execution of the program, When only a TEAT file- 
type exists, the LOAD command will be called, and then the START command. 


Optionally, the uscr may specify as many arguments in the $ command as he wishes, 
provided they all Tit on the same input line. ‘The arguments will be set up as a string 
of double words, one argument per double word, and the address of this string will 
be passed to the specifica file. Each argument will be left adjusted, and any argu- 
ment more than eight characters in length will be truncated on the right. With a file 
whose filetype is EXEC, any arguments specified in the $ command will replace 

the corresponding &n operands in the individual commands of the EXIEC file (see 

-the EXEC coninand, Section 3.5.3, for a full explanation of this opcrand-substitution 
technique). 
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With a file whose filetype is cither MODULE or TEXT, the arguments will be 
placed in a string as mentioned above, and the address of the string may be ob- 
tained by adding 8 to the address contzined in general purpose register 1 at 

the time execution of the specified program begins. Additional arguments may 
be referenced by displacements of 16, 24, 32, etc., from the address thus 
obtained. 


Notes: 


a. Issuing the $§ command for any filename for which an EXEC filetype exists 
is the sane as issuing the EXEC command for that filc. 


b. When a file whose filetype is MODULE or TEXT is used, there must he an entry 
point in that file which is identical to the filename specified in the $ command. After 
the file has been loaded, execution will begin at this entry point. Such an entry point 
will normally be created by the Fortran compiler using the filename specified in the 
FORTRAN command (sce Output under Section 3,4, 2 for exceptions). With Assembler 
language files, the user should create as an entry point or assign as the name of a 
contro] section, the filename by which he wishes to reference the TEXT or MODULE 
version of that file. 


Reponses: 


With files whose filetype is EXEC, cach command in the EXEC file will be typed 
out at the user's terminal prior to its exccution. 


EXECUTION BEGINS ... ; 
This message will be typed out after a file with a filetype of MODULE or TEXT 
has been loaded into core and just before it is started. Any output appearing 
after this message is given will be from the user's program or frorn a part of 
CMS called by that program, and not from the $ command. 


DEFINED MORE THAN ONCE - xxxxxxxx 
‘This message, generated by LOAD, indicates that duplicate entry points or « 
control section names (xxxxxxxx) have Ieen found in the TEXT file being 
loaded, The $ command will be terminated with an error code of 3. 


OVERLAY ERROR 
There is not cnough room in core to hold the TEXT file for which a LOAD has 
been issucd. $ will be terminated with an error code of 3. 








7 ss ‘7-31- 
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If none of the three filetypes is found for filenan q j 
weraree Rel ee Me a : wad for filename OTHER in the user’: 
REFERENCE TABLE OVERFLOW permanent directory, the user's temporary file directory and finally ag 
There are too many entry points or control section names in the TEXT file being system file directory will be searched, using the procedure press fahdven’s 
loaded. § will be terminated with an error code of 3. , Saint anor 


Error Messages: 


THE POLLOWING NAMES ARE UNDEFINED - X2Xxxxxx 44. XXXXXXXX 


The specified names are referenced in the TEXT file being loaded and are never (00001) FILENAME NOT GIVEN. COMMAND FORMAT IS: 
defined. $ will be terminated with an error code of 3. $ FILENAME OPTIONAL ARGS i 
The user has issued the $ command with 2ciLyi 
; P Mas i g 1out specifying a filename. -issue 
DISK ERROR the $ command in the coryvect format. ame ees 
An erzor occurred while cither reading or closing a file whose filetype is 7 
MODULE. This message is generated by LOADMOD, and will cause an error B(00002) NO EXEC, MODULE, OR TEXT VERSION OF FILE xxxxxxxx 
code of 3 to be returned by the $ command. : FOUND. $ COMMAND CANNOT BE EXECUTED ene 
: Ble The nser has specified a filename which does not have a filetype of EXEC, 
Example: ne: or TEST, where xxxxxxxx is the filename which has been specified. 
8 i he LISTE command may be used to verify the existence of the specifica file 
a, $ MYEFILE and to determine its filetype. - 
First the usex's permanent file directory, and then the temporary and system file 
directories, will be searched for a file with a filename of MYPILE and a filetype : ~ FE (00003) LOAD FATLED. 
of EXEC, MODULE, or TEXT, An crror code was returned to the $ command by cither LOAD or ] OADMOD 
: ; © Check the file for duplicate or undefined symbols, overlay errors, or ref- 
If a file exists with a filename of MYIILE and a filetype of EXEC, the commands erence table overflow. ; toa 
which that file contains wil] be executed, and each command will be typed out at 
the user's terminal before it is executed, T(00004) : 
An illegal filemode has been pener; ; 
34 TC ‘ ‘en generated by the system when searching for th 
If filetypes of both MODULE and TEXT or of MODULI: only exist for filename specified file. Attempt to re-issue the Sai ed a 
MYPFILE, the file whose filetype is MODULE will be loaded into core with a = aed 
LOADMON command ard startcd with a START command at entry point MYFILE, ~ F(00005) NAME 1S UNDEFINED - XXXXXKXX 
The filename specified in the $ command is not an ent 
: Pee 5 : . 7 . 7 a not an entry point or a contr 
If only a TEXT filetypo exists for filename MYFILE, a LOAD will be issued to section name in the file which has been loaded. Alter oe ie a at 
bring MYFILE into core, and then a START will be issucd, using an entry point add an entry point so that filename XXXXXXX will also be a eee outs NG 
57) 1 : an a VE int, 
of MYFILE, and re-issue the $ command, 
b. -$ OTHER SAME 1.436 5 A , ; 


If a filetype of EXEC is found on the user's permanent disk for filename OTHER, 
exccution of the EXKC file will take place with the argument SAME replacing &1 
wherever it appears in the EXEC file, 1.436 replacing & 2, 5 replacing &3, and 
A replacing &4, 


If no EXEC filetype exists for filoname OTIIER in the user's permanent directory, but 
a filetype of either MODULE or TEXT is found, the file will be loaded into core and 

started at entry point OTHER. ‘The four user arguments can be accessed by displace- 
ments of 8, 16, 24, and 32, respectively, from the address contained in gencral 
purpose register 1 at the time program OTHER is started. ox 
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3.3.4 
3.3.0 DEBUGGING FACILITIES 

A debugging tool is provided with CMS in the form of the DEBUG command. This com- 

mand allows the user, while at his tezminal, to examine end change the contents of core 

locations, program status words, general purpose registers, the chamicl status word, 

and the channe] address word; to dump portions of core at his terminal or on the offline 

printey; and toa stop and restart programs at any specified point or paints. Methods for 

using these DIEBUG facilities are described in Section 3.3.2, 


In addition to DEBUG, two commands allow the user to trace supervisor calls GVC 
instructions) and hence the internal branches which are issued to the various CMS com- 
mands and functions, These two commands -- SE‘TOVER and SH’TERR — will set certain 
“overrides, or flags, which will be checked cach time an SVC instruction is executed 
and cach time a return is issucd from an SYC-called program. ‘Iwo types of overrides 
may be set: nonmal and ceror. Normal overrides axe those which cause trace informa- 
tion to be recorded for SVC-called progumns which arc cxceuted without encountering 
any error conditions. Laror overrides are those which record information for SVC- 
called prograras which return with an crror code in general purpose rcpister 15. The 
SETOVER command causes both types of overrides to be set. The 81l’PERR command 
will sct error overrides only. 


Yo clear overrides Which have been set by the SETOVER and/or STERR commands, the 
CLROVER command may be issued. Tn addition to terminiting the recording of trace 
inforination, CLROVER will cause all information recorded up to that point to be. printed 
on the offline printer. 


If the user wishes to terminate the recording of trace information during the execution 
of one of his own programs or of a CMS command —i.e., at a point when the CLROVER 
command cannot be issued ~he may do so by hitting the ATTN key twice Q(ausing each 
time fox the keyboard to unlock) and then typing the Ictters KO followed by a carriage 
return. Processing will continuc as before, but no further inforrnation will be recorded 
for SVC's executed afier that point. The KO command will terminate overrides, and 
will also cause recorded trace information to be printed on the offline printer. 


If the user has set overrides by issuing either ox both the SU TOVER end $L'THRR com- 
mands and has failed to clear these overrides, they will be cleared automatically, and 
the recorded information will be printed on the ofGiine printer, when the user logs out 
from the Control Program or when he issues a RESTART request jn the Debug 
environment. 


. 
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CLROVER 
CLROVER 
Purpose: 


° 
The CLROVER command clears overrides set by either or both the 
SETOVER and SETERR commands. It also causes all trace infor- 
mation recorded up to that point to be printed on the offline printer, 


Formats 
TER See mics aie Silos at 
ae 
‘ CLROVER t 
: 2C j ' 
<. s 


Usage: 


This cornmand terminates the recording of trace information begun by 

the SE'TOVER and/or SETERR commands, and causes that information 

to be printed on the offline printer. If CLROVER is not issued, the user 

may clear all currently-active overrides by issuing a FO command as described in 
Section 3.3.0. Also, any overrides which heve been set but not cleared 

at the time the user issues a RESTART request in the Debug enyironment or 

ends his terminal session by logging out from the Control Program will be cleared 


automatically and their trace information will be printed offline. 


CLROVER will cancel the effect of all SH*PTOVER and SETERK commands 
issued since the last KO’ or CLROVER command was issued, or since 

the user's Jast CMS login if neither a KO nor a CLROVER has becn issued 
duzing the terminal session. Once a CLROVIER command has been issued, 
no further truce information wiJ] be recorded until the usex issues another 
SETOVER ox SETERR command. ; 


A sample of the format in which trace information will be printed offline is 
given in Figure 3.3,4-A. Axed amount of trace information is printed for 
ail error overrides; the amount for normal overrides will vary depending on the 
options specified by the user in the SETOVER command. An explanation 
of al! possible fields which could appear in the printout is given under 
Output in this section. — 
Notes: 
a. Ifa CLROVER command is issued when no overrides are currently 
active, it will have no effect other than causing the following Jine to be printed 
on the offline printer: 

*EAGNO LTE --NORMAL- AND ERROR-OVERRIDES HAVE NOW 

BEEN CLEARED #** . 


b. Any operands given in the CLROVER command will be ignored. 


None, 


i 
i 
q 
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CLROVER 


ERRET = Xxxxxxxx 
This information, appearing at the right margin of the first line of printout 
for cach SVC-called program, gives the hexadecimal core Jocation (xxxxxxxx) 
to which the progvam will return if an error code is gencrated during its 
execution, : 


GPRS BEPORE = xxxxxxx oa. XXXXXNNX 
Two Jines of information will be given when this message appears in the 
printout. The firgt line will consist of the contents of general purpose 
registers 0-7 andthe second linc will give the contents of resisters 8-45 
as they exisicd when contrul was passed to the 8VC-called program, 


IPRS BEF ORI. = xxxxxxxn oo. XXXXAXXX P 


This Jine of information will give the contents of the four floating point registers 


as they existed at the tine control was transferred to the SVC-called program. 


GPRS ALTER & XXX XEENK 24. XXXNNAAX 
Two lim s of infoxrmiation will be given when this message appears in the 
pehtout. The firgt line will give the contents of gcueral purpose repisters 
0-7 and the second Jing will vive the contents of resisters 8-415 as they 
existed when a return was jssued by the SVC-called program. 


BPRS AIEER = xMXNAEXN 06. XXNXXNKX 
This line of iptsimation wil) give the contents of the four Moating point 
repisters as they existed when a return wes issued by the SVC-called 
prop rani. 


PARMI. - LIST = xxxxvxw ca... XNKNNNXK 
This racasagee will be followed by cither one or two nes of the parameter 
list which existed at the thuc the SVO wes cxecuted. Refer to Section 
5.4.0 for a discussion of parameter lists and their use. 


ce 









xeceMOTH--NORMAL- AND ERROR-OVERRIDES HAVE NOW 
DEEN CLEARID +5 ++ 
‘Phis message will appear in the printout whenever a CLROVER command 
is issucd, 


Taunples: 

a, CLROVER 

This exemple would clear all currently-active overrides and cause any trace 
information recopded up to that point to be printed on the offline printer. Sce 
Figure 3.3.4-A for a sample of the type of information which would be printed. 
Error Mussepges! 


None, 


OI/O1/es . fy 


bd 
3.3.2-1 ee 
DEBUG _ 
DEBUG 
Por pose: re 


The purpose of the DEBUG command is to provide the user with online 
facilites for debugging his programs and to provide an entry in CMS for 
handling externa] and program interrupts and unrecoverable crrors. 


Format: 


ee eee ed 


{ 
! DIE BUG 
f DEB i 


Usage: ie ' 
The facilities of DEBUG are made available to the user when (1) the DERUG 
command is issued, (2) an external interrupt occurs, (3) a program interrupt 
occurs, (4) a breakpoint is cncountered duving program execution, or (5) an 
unvecoverable error occurs. Once DELUG has becn entered duc to any of the 
above circumstances, the user is said to be in the Debup environment. ‘The 
only valid input in this environmentis the proup of DEBUG requests discussed 
jn this seetion. Vive of the requests -- GO, IPL, KX, RISTURN, and RESTART 
-- cause the user to Ieave the Debug environment. Which of these five requests 
should be isseed depends on the circumstences under which DUSUG hes been 
entered. Refer to the section dealing with cach request for a further discussion 
of its use. 


When the Debug environment is centered, the contents of all peneral purpose 
repisters, the channel status word, and the channel address word will be sayed 

so that they may be examined sud changed, if desired, prior to being restored 
when leaving the Debug environment. If DEBUG is entered via an interrupt, the 
old propvam status word for that interrupt will also be saved. ‘The requests which 
may be issued in the Debug environment allow the use to examine and change the 
contents of these control words and registers as well as portions of the user's 
virtual core. 
sections, 


Mach of these requests is described individually in the following 


Notes: 


a. The KT, Ki, and KO commands are not recognized in the Debug environment, 

hb. Currently the floating point registers may not be examined or changed in the 

Debug environment. To access the floating point registers, the CP consute functions 
DISPLAY Yreg and STONTS Yreg may be used as described in Sections 4.1.4 and 4.1.13. 
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ne D1/010 68 a.5/2%3 Be 
DEBUG DEBUG 
Resnanses: _ (4) All operands longer than eight characters will be left adjusted and truncated 
saa 7 on the right. 
DEBUG ENTERED ... ; (5) All entrics in the DEBUG symbol table are created by issuing the DEF 
This message indicates that DEBUG has been entered in response to the DEBUG request. Below is a list of all valid DEBUG requests: 
command or due to an unrecoverable crror encountered during execution. Any 
DEBUG request may he issucd as soon age the keyboard is unlocked. : Request Page Reference 
DEBUG ENTERED, EXTERNAL INT. BREAK 3. 3. 2- 4 
This message indicates that an external interrupt has caused DEBUG to be : CAW 3. 3. 2-10 
entered, and that the external old program-status word has been saved. Any CSW 3.3.2-11 
DEBUG request may be issued as soon as the keyboard is unlocked. DEF 3.3. 2-12 
DUMP 3.3. 2-15 
DEBUG ENTERED - * GO 3. 3.2- 2] 
PROGRAM INT. PSW = xxxxxxxxNxanxnxxx GPR 3.3. 2- 24 
This message indicates that a program ibterrupt has caused DEBUG to be IPL 3. 3. 2- 26 
entered, The program old PSW has heen saved, and its contents will be KX 3.3. 2-27 
typed out in hexadecimal representation ay indicated by XXNNXXXNNNNNNXXX ORIGIN 3.3. 2- 28 
aliove. Any DEBUG request may be issucd as soon as the keyboard is : PSw 3. 3. 2- 30 
unlocked. RESTART 3. 3. 2-32 
. RETURN 3. 3. 2- 33 
DEBUG ENTERED é SET 3. 3. 2-34 
BREAKPOINT xx AT xxxxxx . STORE 3. 3. 2-38 
This message will he typed when DEBUG is entered due to a previously-set XxX 3,3. 2-42 


breakpoint which has been encountered during the execution of a program. The 
breakpoint will be identified by the number assigned to it (xx) and by the hexa- 


request may be issued as soon as the keyboard is unlocked. 


INVALID DEBUG REQUEST 
The user has specified a request which is not valid in the Debug environment 
or which includes the wrong number of operands. Only the requests discussed 
in this section are valid, and they must be issued, one per line, in the correct 
format. 


Requests: 
Whenever the keyboard is unlocked in the Debug environment, any DEBUG request 
muy be issued. The following rules apply generally when issuing DEBUG requests: 
(1) The parameters, or operands, of each request must be separated by one 
or more blanks, 
(2) The character-delete symbcl, @ , may be used to delete individual characters 
in an input line and n character-delete symbols delete the preceding n characters in . 
the line. 
(3) The line-delete symbol, ¢ , may be uscd to delete itself and all preceding 
characters in an input line. A line-delete symbol cannot be deleted by a character- - 
delete symbol. ‘ 
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3.3. 2-4 
DEBUG 
BREAK 
BREAK ; 
Format: 
PS EE tata ioe iar pemeese ae ves tel sae 
’ ‘ : 
' AK e Gee F symbol 
a eke hexloc ! 
Swaaseat pacciae eae eee E ee cate 
id is any decimal number between 0 and 15 inclusive. 
. symbol fs a name which has been assigned (using the DIF 
- request) to the core address at which a breakpoint 
is to be sct. 
hexloc js the hexadecimal core location Gelattye to the 
, current origin) at which a breakpoint is to be set. 
Usage: ; 


This requast enables the user to stop the exceution of a program at specific 
instruction locations, eatled "breakpotuts. " Issutngs the BRUSAK request 
will cause only one breakpoint to Le set, separate PRIEAK requests MUse he 
issucd for cach breakpoint desired. A. rnaximum of sixtecn breakpoints 
ray be in effect at any given Hime, and any attynpt to sek more than sixteen 
will be rcjected. | 


‘The first operand of the DRUAK request specifies the identi fication number 
to be assigned to the breakpoint being set, and must be a decimal mumbex 
between O and 15 inclusive. If an identification number is specified which 
is the same as that of a cureently set breakpoint, the previous breakpoint 
will be cleared and the new one will he set. 


"The second operand af the BREAK request indicates the core address at 
which the breakjoint is to be set. Hf this operand contains any non-numeric - 
characters, the DUBUG syimbol table is searched fox a matching symbol 
entry. Ia match is found, the breakpoint will be set at the core address 

to which the symbol name is assigned, provided that address is on an even 
(halfword) boundary. foe match is found in the DEBUG symbol table, or 
ifthe second operand contains only numeric characters, the current oripin 
(as established by the ORIGIN request) will be adder to the specified oper? 
and and the breakpoint will be set at the resulting core addecss, provided 
that address is on a halfword boundary. 
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* 3.3.2-5 ~ 
pesuc § o¢7 


BREAK 


The DEBUG program sets a breakpoint by saving the contents of the byte 
-located at the core address specified by the second operand of the BREAK 
request. ‘This byte is then replaced by the byte 'Ex', where x is the hexadecimal 
equivalent of the breakpoint identifier specified in the first opexand. In order 
for the breakpoint sctting to have meaning, the core address indicated by the 
second operand must be the location of an operation code. Thus, when the 
location is encountered during program execution, a program interrupt will 
occur (since all values EQ through EF are invalid operation codes) and control 
will be trausferred to the Debug environment. In DEBUG the invalid operation 
code will be recognized as a breakpoint, the original operation code will be 
replaced, and a message will be typed out identifying the breakpoint which has 
been encountered, 


Mipure 3. 3, 2-B indicates the procedure normally used for satting breakpoints. 
Virst the program is loaded into core. The DEBUG command is then issucd to 
transfer control to.the Debug environment so that breakpoints nay be set prior 

to beginning execution of the program. After the desired breakpoints have been 
set, a RETURN request should be issucd to return contro] to the CMS Command 
environment. Issuing the SPART command will cause program execution to 
begin. Whenever a breakpoint is encountered, a messape to that effect will be 
typed out, control will return to the Debug environment, and the keyboard will ; 
be unlocked to accept any DELUG request except RETURN, Issuing the GO request 
will cause propram execution to continue from cither a specificd location or the 
location at which the breakpoint had been set. 


Notes: 


a. Abreakpoint .is cleated whenever it is encountered during program execution. 


b. ‘To determine the core addresses of instructions at which breakpoints are to be 
sect, a listing of the program(s) in assembler language mnemonics should be used 
together with a load map. Assembler Janpuage mnemonics may be obtained in 
Fortran listings by specifying the LIS'T option when the FORTRAN command is 
issued. See Vipure 3.3,2-A. To obtain a load map, the TYPE option should be 
specified in the LOAD command, as shown in Fipure 3. 3, 2-B. 
~ c. Even if the address specified for a breakpoint sctting is on a halfword Loundary, 
the byte atthat addxess may not contain an operation code. Jt is up to the user to 
make sure that breakpoints are set only at operation code locations. Otherwise, 
the breakpoint will not be recognized during exccution and may penerate other 
errors by overlaying data or seme part of an ipstruction ather Uhan the operation 
code. : 


ad. No breakpoints should be set below hexadecimal core location 100, since this 
area is reserved for hardware control words, and will not contain exccutable code; 


NLL 
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3. 3. 2-6 a 
DEBUG. 
BREAK 


«. Ifa BREAK request is issued which specifics a core address at which 
a breakpoint is currently active, the second breakpoint will also be set 
at that same location. When this brealpoint is encountered during execu- 
tion, the identification number of the most recently set breakpoint will be 
typed out. ‘Phe second time this core location is rcached during program 
execution, the identifier of the second-most recently set breakpoint will 
he typed, and so on, Whenever DEBUG has been cuiered duc to a break- 
point interrupt, issuing tie GO request without an opcrand will cause 
execution to begin at the location where the breakpoint was encountered, 
if more than one breakpoint has been set at this location, the additional 
breakpoint(s) will cause DEBUG to be re-entered. 


f. Issuing a RESTART request will cause any breakpoints set at locations 
greater than hexadecimal 12000 to be cleared; Uiose below 12000 will re- 
main sct. 


Responses: 
If the BREAK request has been correctly issued, the keyboard will be un- 
locked following a carriage returu, and the system will be ready to accept 
another DEBUG request. 


INVALID DEBUG REQUEST 
This response indicates that the wrong nurber of operands have been 
specified in the BREAK request. “Two and only Gwe operands must be 
specified. 


INVALID ARGUMENT 
This message indicates that either (1) the breakpoint identification 
number specified in the first operand is not a decimal number between 
6 and 15 inclusive, or (2) the second operand cannot be Jocated in the 
DEBUG symbol lable and is not a valid hexadecimal number, If the 
second operand is intended to be a symbol], a DEV request must have 
been previously issued for that symbol; if not, the operand must 
specify a valid hexadecimal core location, 


INVALID CORE~ADDRESS 
The core location indicated by the second operand is cither uneven (not 
on a halfword boundary) or the sum of the second operand and the current 
ovipin value is greater than the user's virtual core size. If the current 
origin value is unknown, it may be reset to the desired value by igsuing the 
ORIGIN request. 


— t 
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26.99 eee 
DEBUG. 

BREAK 


REPLACES OLD BREAKPOINT xx AT xxxxxx 
This response indicates that the BREAK request just issucd specifies 
a breakpoint identifier (xx) which has already been assigned to a currrently 
active breakpoint. The old breakpoint (at core location xxxxxx) will be 
cleared and the new breakpoint will he sect. 


DEBUG HNTERED 

BREAKPOINT xx A'T x:00%x 
This message will be given whenever a breakpoint is encountered during 
program execution. xx is the breakpoint identifier and xxxxxx is the core 
address at which the breakpoint has been cucountered. Afier the message 
is typed, the keyboard will be unlocked to accept any DEBUG request ex- 
cept RLTURN. 


a. BREAK 1 18C 
The current oripin value will be added to 18C and the byte at the resulting core 
address will be saved and replaced by the byte EL". Refer to Figure 3. 3. 2-B 
where the oripin was set to 12000, and the instruction at which bsxcakpoint 1 was 
sct is the sccond from the last iustruction shown in Figure 3.3. 2-A. Note that 
the Joad map indicates that program PRIME was loaded at 12000. Setting the 
oripin to 12000, therefore, means thet the stutcment locations shown in the 
listing of program PRIMI may be'used in setting breakpoints. When breakpoint 
lis encountered during program exccution, the message 

DEBUG ENTERED 

BREAKPOINT OL A’T 01218C 

is typed out. 


bh. BREAK 3 AAA 
The byte at the address assigned to. symbol AAA will be saved and replaced by 
the "E33". In Figure 3.3. 2-B, a DEF request is issued which assigns symbol 
AAA to location 1A4, relative to the current origin of 12000.. Breakpoint 3 will 
therefore set at core address 121A4, as indicated by the message 
DEBUG ENTERED 7 
BREAKPOINT 03 A'T 0121A4 
which is typed out when the breakpoint is encountered during program execution. 


. 
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3,3.2-8 AUS 
DEBUG, 
BRIEAK 
pr’ -f prime listing 
FORTRAM IV G LEVEL 0, MOD 0 PRIME DPATF = 67080 ] 
GC.» PRIME NUMBER PROBLEM ; 
0001 100 WRITE (6,8) 
0002 § FORMAT (27H PRIME NUMBFRS FROM 1 TO 50/2X,1"1/2X,12/2X%, 1'!3) 
0003 101 J=5 
000% 3 Azl 
0005 102 A=SORT CA) 
0005 103 JeA 
0007 104 00 1 K=3,d,2 
ovuds 105 LEIl/K 
0009 ; * 106 TFCLekK=1)1,2,4 
0010 1 CONTINUE 
0011 107: WRITE (6,5)1 
0012 5 : FORMAT (13) 
0013. 2 "fHl[42 ‘ 
0014 108 IF(50-1)7,4,3 
0015 4 WRITE (6,9) 
0016 9 FORMAT Cla PROGRAM ERROR) 
0017 7 WRITE (6,6) 
0013 ~ 6 FORMAT CH END) 
0019 109 STOP 
0020 END 
FORTRAN IV G LEVEL 0, HOD 0 PRIME DATE = 67080 i] 
'SOATION STA NUM LABEL op OPERAND Ben OPFRAN 
.00900 BC 15,12¢0,15) 
900004k oe O6D7D9C9 
COOOGS dC DRCSHONO 
ooGcOo0uC STM 14,12,12(13) 
000010 LM 2,5,80(15) 
000014 LR 4,13 
000016 L 13,36(0,15) 
OOO01A ST 13,8(0,4) 
OO001E STM 3,4,0(13) 
000022 BOR 15,2 
000021; ole 000900000 Al 
000028 De 00000000 A20 
00002C Dt 00000000 A36 
000168 A36 L 13,4(0,13) 
O00016C : , L 1h,12(0,13) 
000170 LM 2,12,28(13) 
O00174h MVI 12(13),255 
000178 BER 15,14 
O0017A4 A20 L 15,160(9,13) rBCaMy 
OO017E : LR 12,13 
000180 LR 13,4 
000182 BAL 145,64(0,15) 
000186 LR 13,12 
000183 1: 100 L 15,160(0,13) tHCOME 
00018C BAL 14,4(0,15) ~ 
00190 ne 7 


Figure 3,3,2-A. Sample output created by a FORTRAN command in ' 


00000006 


which the 1ST option was specified. 


FIGURE 
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3.3.2+-9 

DEBUG 
BREAK 


load prime (type) 
PRIME # AT 12000 
PRIME AT 12000 
THCFCOMH AT 122c0 
SAVAREA AT 13288 
VFIOCS AT 13128 
IBCOM? AT 122C0 
FOIOCS# AT 1237¢ 
{HCSSQRT AT 132F8 
SQRT AT 132F8 
THCECYTH AT 133A8 
ADCON# AT 133A8 
INTGSW AT 14409 
FCVEO AT 13£52 
FCVLO AT 1562A 
FCVIO AT 13960 
FCVvco AT 1hO5h 
FCVAD = AT 1359A 
FCVZO AT 134F4 
THCFIOSH AT 14428 
FIOCS# AT 14428 
THCTRCH AT JhFCO 
JHCUATBL AT 15238 
R; Y50,37 


debug 
DEBUG ENTERED... 


origin 12000 
break 1 18¢ 
def aaa la4 
break 3 aaa 


return 
R; T=0,02 


start 

EXECUTION BEGINS,.,. 
DEBUG ENTERED 
BREAKPOINT OL AT 01218C 


Lae) 

PRIME NUMBERS FROM 1 TO 50 
1 
2 


—, 
DEBUG ENTERED 
BREAKPOINT 03 AT 0121A4 


3,3,2-B. Sample procedure for setting breakpoints. 


3) 
of Oe. 
rr fy 


ete 01/01/68 
3, 3, 2-10 
DEBUG 
CAW 
wee iW 


Format: * 


Tape OPA ee t 

t 1 

1 CAW 

Bd eficale Aca cre : 
Usage: 


‘This request will cause the contents of the channel address word which 
existed at the time DEBUG was entered to be typed out at the terminal. 
‘The channel address word (CAW) specifies the storage protection key 
and the core addvess of the first channel command word associated with 
the next or most recent START 1/O. The chamiel address word, located 
in hexadecimal core location 48, is saved at the time DEBUG is entered. 
The CAW has the following format: 


‘Bits , Contents 


0-3 Protection key which is matched with a key 
in stovage whenever reference is made to 
main storage. 


4-7 Not implemented; currently set to zeros. 


§-31 Command address, indicating the hexadecimal 
core location of the first channel command 
word associated with the next or the most re- 
cent START I/O. 


For a further discussion of the channel address word, refer to IBM Manual 
A22-6821, Principles of Operation: 


If the request has been correctly issucd, the contents of the channel address word 
will be typed in hexadecimal representation at the terminal and, following 

a carriage return, the keyboard will be unlocked to accept another DEBUG 
request. Sec Figure 3. 2.2-F for an example of response to the CAW request. 


INVALID DEBUG REQUEST 


‘This response to the CAW request indicates that one or more operands 
have been specified. Re-issue the request in its correct format. 


—- 


01/01/68 : 
3.3. 2-11 oe 
DEBUG 
csW 
Format: 
i ns eer ene ne ede eer 
: ‘ 
' CSW H 
' i 
Usage: 


This request will cause the contents of the channel status word which existed a 

the time DEBUG was entered to be typed out at the terminal. The channel status 
word (CSW) indicates the status of a channel or an input/outpit device, or the 
conditions under which an J/O operation has been terminated. The CSW is formed 

in the channel and will be stored in hexadecimal core location 40 when an I/O 
interruption occurs. If 1/0 interruptions f:ive becn suppressed, the CSW will 
gencrally be stored when the next START I/O, TEST I/O, or HALT I/O instruction 
is executed. The CSW is saved when D1iBUG is entered and has the following format: 


Bits . Contents 


0-3 ' Protection key, moved from the CAW and 
uscd to indicate the protection key under 
which I/O was started. 


4-7 Not implemented; currently set to zcrocs. 


8-34 Neat comimand address, a pointer to the 
core location eight bytes greater than the 
address of the last chammel command word 
exccuted. 


32-47 Status bits, indicating the conditions in the 
device or the channel that caused the CSW 
to be stored. 


48-63 Residual count, indicating the difference in 
the number of byies specified in the last- 
exccuted channel command word and the 
number of bytes which were actually transferred. 


For a further discussion of the channel status word and its use, refer to IBM 
manual A22-6824, Principles of Operation. : 


Responses: 


If the request has heen correctly issued, the contents of the CSW will be typed 
out at the terminal in hexadecimal representation. A carriage return will then 
be issued and the keyboard will be unlocked to accept another DEBUG request. 
For an example of response to the CSW request, sce Figure 3. 3.2-F. 


INVALID DEBUG REQUEST 
This response to the CSW request indicates that one or more operands have been 
specified. Re-issue the cequest in its proper format. 








Tif 





01/01/68 - 
3.3. 2-12 Joy 
DEBUG” of 7/ 
DEY 
DEF 
Format: 
a a oe a OR ee eC ah aS ca os tee eg H 
1 ' f byte count \ 
' DEF ' symbol hexloc 4 t 
ae, 
4 4 ‘ 
ee dee wm eee ween ee ewe eee eee eee 
symbol is the name to be assigned to the core address 
derived from the second operand, hexloc. 
hexloc is the hexadecimal core location, relative to 
° the current origin, to whic® the name specified 
in the first operand is to be assigned. 
hytccount is a decimal number between 1 and $6 inclusive 
which specifies the length attribute (in bytes) of 
the symbol specitied in the first operand, 
Usage: 


The DEF request allows the user Co assign a symbol name to a specific core 
address and to refer to that address in other DEBUG requests by the assigned 
name. The symbol name is specified as the first operand of the DEF request. 
It may be from one to cight characters in length and must contain at Jeast onc 
non-numeric character. Also, the first character of the symbol name should 
not be un asterisk. Any name longer than cight characters will be left-adjusted 
and truncated on the right. 


The second operand of the DHT request specifies a hexadecimal number which 

asi ie &: 6] it 
will be added to the current origin (as established by the RIGIN request). ‘The 
sum of these two values will be the core address to which the symbol] name will 
be assigned, 


The third operand of the DEF request is optional and, if given, must specify a 
decimel muinber between 4 and 56 inclusive. This number is the length attribute 
(in bytes) of the symbol narne. If the third operand is ornitted, a default attribute 
of four bytes will be assigned. 


When the DEF request is issued, an entry is made in the DEBUG symbol table 
indicating the symbol name, the core address to which it is assigned, and the 
length attribute of the symbol. Symbols will xeinain defined until a new DEF 
request is issucd for them or until the user obtains a new copy of CMS by 
issuing an IPL request in the Debug environment or in the Control Program 
environment. 


01/03/68 
3.3, 2-13 


If a DEF request is issued which specifies a symbol that has been previously 
defined, the previous core address will be replaced by the more recent core 
addzess for that symbol in the DEBUG symbol table. DEP requests which 
specify additional symbo] names for core Jocations to which a symbol name 
has already been assigned will cause additional entries in the DEBUG symbol 
table, so that multiple symbole may be assigned to the samc core address, 


a. Only 16 symbols inay be defined in the Debug environment at any given time. 


b. Issuing a new ORIGIN request will not affect the core address to which an 
alarcady-defined symbol is assigned. 


ce Symbols assigned using the DEF reyuest are defincd for use only in the Debug ° 


environment. These symbol definitions will not be cleared when a RESTART 
request is issued. - 


Responscs: 


If the DIET’ request has been correctly issued, a carriage return Will be given 
aud the keyboard will be unlocked to accept another DEBUG request. 


INVALID DEBUG REQUEST 
This response to the DEF request indicates that either less than two or more 
than three operands have heen specified. Re-issue the request in its correct 
format. 


INVALID ARGUMENT ; : 
This message indicates that cither (1) the name specified in the first op2rand 
contains all numeric characteyss, 2) the second operand is not a valid hexadecimal 
number, or (3) the third operand is not a decimal nuraber between 4 and 56 in- 
clusive, , 


INVALID CORE-ADDRESS 
This response will be given when the sum of the second operand and the current 
origin is greater than the user's virtual core size. If the current origin value 
is unknown,’ resect it to the desired value by issuing the ORIGIN request and 
then re-issue the DEF request. 


16 SYMBOLS ALREADY DEFINED 
If this message is given, the DEBUG symbol table has heen filled and no new 
symbols may be defined until the current definitions are cleared by obtaining 
anew copy of CMS. An existing symbol may be assigned to a new core location, 
however, by issuing another PEF request for that symbol. 


01/01/68 
3.3.2-14 
DEBUG 

DEF 


Exam’ es: 


a. DEFINE IN1 12F5A 
‘The current oxigin value will be added to 42F5A and the symbol name IN4 will 
be assigned to the resulting hexadecimal core address. A length attribute of 4 
(the default valuc) will be assigned to symbol IN4, and an entry for INI will be 
made in the DEBUG symbol table. 


b. DEFINE K 13 42 . 
The currently defined origin will he added to the hexadecimal value 13, and the 
resulting addyess wil] be assigned the symbol name K. An entry for K will be 
made in the DEBUG syinbol table, and its length attribute wil) be 42 bytes, as 
specified. 


Ai 


01/01/68 

3. 3.2-15 - 

DEBUG eee 
DUMP 


.DUMP 


Format: 


ONLINE symbol 1 symbol 2° 
ident hexloc 1 hexloc 2 


* 
3 


an ee eee ee 


ONLINE indicates that output from the DUMP request 
is to be typed at the terminal. 


ident indicates that DUMP output is to he printed 
on the offline prfaicr, and is the name by 
which that printout will be identified. 


is a name assigned (using the DIS’ request) 
to the core address at which the dump is to 
begin. 


symbol 1 


hexloc 1 is the hexadecimal core location, relative to 
the current oripin, at which the dump is to 
begin. 

symbol 2 is a naine assigned (using the DEF request) 

to the core address at which the dump is to 

end. ; 


hexloc 2 is the hexadecimal core Jocation, relative to 
the current origin, at which the dump is to 


end. 


- indicates that the dump is to end at the last 
address of the user's virtual corc. 


Usage: , 


This request is used to dump the contents of all or part of the user's 
virtual core either on the offiine printer ox at the terminal. If the user 
specifies "ONLINE" as the first operand of the DUMP request, the con- 
tents of the specified core locations will be typed at his terminal; other- 
wise the information will be printed offline and will have the heading 
DUMP --- xxxxxxxx, where xwxxxxxx is the identifier specificd as the 
first operand of the DUMP requcst. 





At 


. 03/01/68 


3, 3. 2-16 
DEBUG _ 


: DUMP 


The second and third operands specify the portion of core which is to 
be dumped, and arc optional. If they are not given, the core address 
specified in the most recent DUMP request will be used or, if no pre- 
yious DUMP request has been issued, one word (four bytes) of core will 
be dumped starting at location 0. ~ 


If the sccond and third operands are specified, the core addresses to which 
they refer are determined as follows: If the second operand contains any 
non-numeric characters, the DEBUG symbol table is searched for a match- 
ing symbol ciitry. Ifa match is found, the core address to which that 
symbol name is assigned will be used as the address at which the dump is 
to begin. If no match is found, or if the operand contains only numeric 
characters, the current origin (as established by the ORIGIN request) will 
be added to the specificd eperand. The resulting core address will be used 
as the begining address of the dump, provided it is not greater than the 
user's virtual core size. ‘The core address at which the dump is to end is 
given by the third operand of the DUMP request. If an asterisk is specified 
for this operand, all of core from the starting address to the end of core 
will be dumpéd. If an asterisk is not specified as the third operand, the 
same procedure is used to determine the ending address of the dump-as 
that described above for the starting address. Both addresses must be 
within the address range of the user's virtual core, and the address speci- 
fied in the third opexand must be greater than that specified in the second. 


The first two lines of output from the DUMP request will give the contents 
of general purpose repisters 0-7 and 8-15 respectively. Thercafter, the . 
contents of the specified portion of core will be given, 32 bytes per line, 
The core address of the first byte-in the line’ will be given.in the lefr-most 
column of the dwyp and WH always be on a fullword boundary. This. means 
“that the conténts of the complete fullword in which the starting (and ending) 
addresses occur will be included in the dump. Ali information given in the 
dump, including the core addresses, will be in hexadecimal format, 


Notes; 





a. To stop the typeout of an online dump, hit the attention key once to 
enter the CP environment, and then issue the NXTERNAL console function. 
This will simulate an external interrupt and will transfer contro] to DEBUG. 
The dump will have been canceled and the keyboard will be unlocked to 
accept any DEBUG request except RETURN. 


2l8/ 


01/68 
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DEBUG 24-2. 
DUMP 


b. Hitting two attention interrupts during an online dump will not cause 
the keyboard to unlock. Rather, the dump typeout will continue and the - 
spacing of the interrupted line and the line immediately following it will 
be incorrect. To stop the typeout of an online dump, use the procedure 
described in Note a. , 


Responses; 


If ONLINE has been specified, the contents of the general purpose reg- 
isters and the requested portion of core will be typed out at the terminal, 
followed by a carriage return, and the keyboard will be unlocked to ac- 
cept another DEBUG request. , 
If ONLINE has not been specified, a carriage return will be issucd and 
the keyboard will be unlocked to accept another DEBUG request. The 
requested information will be printed offline as soon as the printer is 
free and ready, 


INVALID DEBUG REQUEST 
Iither no, two, or more than three operands have heen specified in the 
DUMP request. Re-issue the request, specifying either one or three 
operands. 


INVALD) ARGUMENT 
This message will be given if either (4) the address specified by the third 
operand is less than that specified by the second operand or (2) the second 
and/or third operands cannot be located in the DEBUG symbol table and are 
not valid hexadecimal numbers. If either operand is intended to be a symbol, 
a DIF request must previously have becn issued for that symbol; if not, the 
operand must specify a valid hexadecimal core location. 


INVALID CORE-~ADDRESS 
The hexadecimal numbex specified in the second or third operand, when 
added to the current origin, is greater than the user's virtual core size. 
If the current origin value is unknown, reset it to the desired value by 


-issuing the ORIGIN request and then re-issue the DUMP request. 


Examples: 


a, DUMP ONLINE 

Since the portion of core to be dumped has not been specified in this request, 
the last scttings specified in a DUMP request would be’ used ox, if no settings 
have been specified during the current terminal session, four bytes of core 
will be typed out, starting with location 0. Sce Figure 3.3.2-C. 


ae = e (- 4 t- 
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3.3. 2-18 
: DEBUG 
DUMP 
: oO a o 
O0O000 MME a Oa 
eel Geel eel aoe no one | ~h ‘ oa wm 3 
' BON BB fh oOo U 
= 3 oOnDooo wo o Oo eo 
b. DUMP ONLINE 12000 END Ee. Ad 9 3 o 119 
: . ao Q a~1 mas 
The contents of core from the address which is the sum of 12000 and the at aa 
a cay : 2RT) wari — ~ 
current origin value up to the address identified by the symbol END will Wn oe Oo A3 N 2 ©8Oo3 
kat S . as 4 eee] bo fas coo U1 mom oOo tad oor 
= he typed out at the terminal. Refer to Figure 3. 3.2-C, where the origin , Guero Ga te) So oa” 
7 a : . . . fia co oo cor WN = Q 
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3. 3, 2-20 ; DEBUG 4G 
DEBUG | GO 


~ 


DUMP my 
GO 


Format: 


T 5 ' 

' i) 

‘ symbol ' 

sd [ hexloc | 

1 1 
symbol is a name which has been assigned (using the DEF 


request) to the core address at which execution is 
to begin. 


hexloc is the hexadecimal core location, relative to the 
current origin, at which execution is to begin. 


‘Usage; 


The GO request causes the user to leave the Debug environment and to 
begin execution at cither a user-specified address or at the address con- 
tained in bits 40-63 of the old PSW for the interrupt which caused DEBUG 
to be entered. ‘This PSW is saved when DEBUG is entered, and is loaded 
to become the current PSW when a GO request is issued. Lf an operand is 
specified in the GO request, the instruction address portion of the PSW 
will be altercd to contain the address indicated by that operand before th 

“ PSW is loaded. : 


The core address indicated by the GO operand.jis determined as follows: 
If the operand contains any non-numeric characters, the DEBUG symbol 
table is searched for a matching symbol entry. If a match is found, the 
core address to which that symbol name is assigned will be used as the 
location at which execution is to begiv, and will be moved to the saved 
old PSW. Ifno match is found in the DEBUG symbol table, or if the oper- 
and contains only numeric characters, the current origin (as established 
by the ORIGIN request) will be added to the specified operand and the re- 
sulting address will be moved to the P5W, provided it is not preater than 
the usex's virtual core size. : : 


Prior to loading the PSW, the genera] purpose registers, channel address 
word, and channel status word will be restored as they existed when 
DEBUG was entered, or, if they have becn modified by the user in the 
Debug environment, to their modified contents. The saved old PSW will 
then be loaded by DEBUG to hecome the current PSW, and cxecution will 
bepin at the specified instruction addvess. 


A ] G7 : 03/03/68 
| 01/01/68 a 3.3.2-23 wine 
3.3. 2-22 DEBUG 
DEBUG : 3 GO 
GO ; } 
Examples: 
a. GO 
The old program status word for the interrupt which caused DEBUG 
to be entered will be loaded as the current PSW, and execution will 
Netes: begin at the address specified in bits 40-63 of that PSW. 
a. ‘The GO request should not be issued without an operand unless the 
Debug environment has been entered due to a breakpoint interrupt or to b. GO INN 
an external or program interrupt. The DEBUG symbol table will be searched for symbol INN and the 
address to which that symbol is assigned will be loaded into hits 
b. When an operand is specified, the GO request may he issucd at any 40-63 of the old PSW prior to loading it as the current PSW. Control 
time in the Debug environment, except when DEBUG has been entered to will then pass from the Debug environment and execution will hegin 
set breakpoints in a program prior to starting it. at the core address to which symbol INN refers. 
c. If an operand is tpecified in the GO request, the address to which it c. GO 42345 ‘ 
refers should be the core location of an operation code. The current origin will be added to location 12345 aud the resulting 
; address will be placed in bits 40-63 of the old FSW prior to loading it 
Respanses! as the current PSW. Control will then be transferred from the Debug 


lt the Go request has been issued successfully, a carriage return will be environment and cxecution will begin at the specified address, 
issued and execution will continue from the address contained in the PSW 


which has been loadacd. 


INVALID DERUG REQUEST 
This responce indicates that more than onc operand has been specified in 
the GO request. Re-issue the GO request in its correct format. 


INVALID ARGUMENT 
An operand has been specified ia tue GO request which cannot be located in 
the DESUG svinbel table and which is not a valid hexadecimal number. If 
the operand is intended to be a aymbol, a DEY request must have becn pre- 
viously issucd for thet symbol; if not, the operand niust specify a valid 
hexe kecimal core location. 


INVALID CORE-ADDRESS 
The acdress at which excculion is to begin is cither not on a halfword : 
bourdery (indicating that an operation code is not located at that address) 
or the sum of the GO eperand and the current origin value is greater than 
the user's virtual core size. It the current origin valuc is unknown, it 
may bo reset to the desired valuc of igsuing the ORIGIN request. 


INCORRECT DEBUG IEXVP 
The GO request has been issued without an operand when DEBUG had not 
been qitered due to a breakpoint, external, or program interrupt. ‘The 
IPL, KX, or RESTAR’T requests may be issued in this case; GO may be 
issucd with an operand; or the RETURN request may be issued if DEBUG 
had been entered via the DEBUG command. 











regN. 


Usage: 


eee tee ee 


a 


01/01/68 


3.3.2 -24, 


DEBUG 


GPR 


is a decimal number from 0-15 inclusive, 
indicating the first or only general purpose 
register whose contents is to be typed out, 


is a decimal number from 0-15 inclusive, 
indicating the last gencral purpose register 
whose contents is to be typed out, 


The GPR request may be used to inspect the contents of one or 
more gencral pirpose registers as they existed when DEBUG was 


entered, 


If only one operand is given, the contents of the specified 


register will be typed out at the terminal, If two operands are piven, 


the contents of the registers specified by the first through the second 


opcrand, inclusive, 


will be typed out, 


Both the first and second operands must be decimal numbers from 
0.15, and the second operand must be greater than the first, 


Responses: 


If the request has been correctly issued 
specified will be typed at the terminal -~ one per line -- and 
a carriage return, the keyboard will be wnlocked to acccpt another DEBUG 


request, 


INVALID. DEBUG REQUEST 


, the contents af the register(s) 


, following 


This message indicates that either none, or more than two, operands 


have been specific d, 


INVALID ARGUMENT 
‘rhis response will be given if the operand(s) specified are not decimal 


numbers between 0 and 15, 


first, 


lixamples: 


a, GPR 


Re-issuc the request in its proper format, 


or if the second operand is less than the 


The contents of general purpose register 8 as it existed when DEBUG 


was centered will be typed out at the terminal, 


b, GPR. 5 15; 


(See Figure 3, 3, 2-F), 


The contents of general purpose registers 5 through 15, inclusive, 


will be ess gui as they 
Fipure 3,3, 


existed when DEBUG was entered, (See 


‘gpr 8 


OO2A1A8E 


“-ppr 5 35 
OOOASNONS 


002A1A88 
00009838 
OO2A1A88 
00000100 
80009670 
SO0009F BA 
600095C2 
00011040 
0000550C 
00009588 


FIGURE 3. 3.2-E. Examples of the GPR request. 


ane 


01/01/68 
3. 3. 2-25 


DEBUG = fo 


GPR 


01/01/68 
3.3.2-26 
DEBUG 
IPL 


IPL 
Format: 


Usace: 
The IPL request will couse control to transfer from the Debug environment to the 
CMS Command environment. IPL may be issued ef any time when the keyboard 
is unlocked in the Debug environment, regardless of the circumstances in which 
DEBUG has been entered. 


Issuing the IPL.request will cause a new copy of the CMS nucleus to he brought 
into core from the system disk. This new copy will overlay the user 8 former 
copy of the nuclcus, causing all symbols which had been previously defined by 
DIF requests to be cleared from the DEBUG symbol table. 


av BPG 





CMS INITIALIZED 
This response indicates that the IPL request has been successfully executed and 
that control has passed from the Debug environment to the CMS Command environ- 
ment. The keyboard will be unlocked, following a carriage return, to acccpt any 
CMS command. ; 


INVALID DEBUG REQUEST 
This response indicates that one or more operands have been specified in the IPL 
-xequest. Re-issue the request in its correct format. 


aft 


—ooros 2 
3.3.2-27 
DEBUG 
KX 
KX 
Format: 


t 

' 

‘ KX 
4 

eanwe One mewn mwnt 
Usage: 


‘The KX request will close all open files and I/O devices, update the user's file 
directory, and transfer control from the Debug environment to the CP environ- 
ment. This request muy be issued whenever the keyboard is unlecked in the Dehue 
environment, regardless of the circumstances in which DEBUG has been cutered, . 
In order to obtain a new copy of CMS once the KX request hac been issued, an 
IP] console function must be issued in the CP environment. 


Responses: 


KILLING CMS EXECUTION... 
P-DISK: xxxx RECORDS IN USE, xxxx LEIT (of xxxx), 
xx% FULL (of xxx CYL.) 

This responsc indicates that the KX request has been executed and that 
coutrol has passed to the CP environment. The keyboard will be un- 
locked to accept any CP console function, The three xxxx ficlds in the 
above message indicate the number of 800 byte recoxds on the user's 
permanent disk area which are in usc, free, and assigned, respectively. 
xx specifics the percent of assigned records in use, and xxx is the 
number of cylinders assigned to the user, 


INVALID DEBUG REQUEST 


This response indicates that one or more operands have been specified 
in the KX request. Re-issuc the request in its correct format. 





~ 


: 01/01/68 Gg) 
3. 3,2 -28 fps 
DEBUG 


“ORIGIN 


tee! 


“IGIN 


Format: 


Usage: 


symbol > 
hexloc 


symbol is any name which has been assigned to 
a core address using the DET request. 
hexloc is any hexadecimal core location between 


0 and the end of the usex's virtual core. 


This request allows the uscr to specify an "origin", or base address, 
which will be added to the hexadecimal) locations specified in other 
DuLUG requests.. lor cxaniple, the ORIGIN request enables users to 
specify distruction addresses relative to program load points, rather 
then to 0, while operating in the Debug environment. Lf the ORIGIN 
request is not issued, all hexadecimal locations specified in DEBUG 
requests are assinned to be relative to 0. 


When an ORIGIN request is issued, the origin setling is determined as 
follows: Ifthe ORIGIN operand contains any non-numeric characters, 
the DEBUG syn:bol table is scarched Jor a matching symbol entry. lfa 
muteh is found, the core address to which that symbol name is assigned 
will become the New oripin setting. Lf no match is found in the DEBUG 
syinbol table, or if the operand contains only numeric characters, the 
addiess specified in the operand will become the origin sctting. 


Any origin set by:an ORIGIN request will remain in effect until another 
ORIGIN request or a RESTART request is issucd, or until the user ob- 
tains a new copy of CMS.) Whenever a new ORIGIN request is issucd, 
the value specifidd ja that request will overlay the previous oripin set- 
ting. Jf the user obtains a new copy of CMS or issues a RESTART re- 
quest, the origin will be set to 0 until a new ORIGIN request is issugd. 





. 01/01/68 
3, 3,2 -29 72 
DEBUG ie Se 
ORIGIN 


Responses: 


If this request has been correctly issued, a carriage return will be given 
and the keyboard will be unlocked to accept another DEBUG request. ‘ 


INVALID DEBUG REQUEST ; 
This response indicates that the wrong number of operands have been 
specificd in the ORIGIN request. One and only one operand must be 
specified. 


INVALID ARGUMENT 
The operand specified in the ORIGIN request cannot be located in the 
DEBUG symbol table and is not a valid hexadecimal number. If the 
operand is Intended to be a symbol, a DELP xcquest must have been pre- 
vously issued for that symbol; if not, the operand must specify a valid 
hexadecimal core location. 


INVALID CORU-ADDRIESS 
‘The address specified by the ORIGIN operand is greater than the user's 
virtual cove size, 


Examples: 


a. ORIGIN 12000 
‘The origin will be set to the hexadecimal value of 12000. Thereafter, 
12000 will be added to all hexadecimal locations specified in other 
DEBUG requests and the resulting core address will be referenced, 


b. ORIGIN XYZ5 

The absolute address assigned to symbol XYZS5 (provided an entry for 
XYZ5 exists in the DEBUG symbol table) will become the new origin 
setting, This sctting will be added te all hexadecimal locations speci- 
fied in other DEBUG requests thereafter, and the resulting core address 
will be referenced. 


Var . qe ae : : ‘ “Y y Jee 
ap? ot fh in! A ih & bys 
, 01/01/68 - / 3.3.2 -31 off l 
3.3. 2-30 DEBUG 
DEBUG Psw 
PSW F 
rsw 15 Problem state flag, set to 1 when the machine 
is operating in the problem state rather than 
Format: the supervisor state. 
i, oe pe ' 16-31 Interrupt codec, showing the source of the 
1 PSW : interrupt (for external interrupts) or the 
' i cause of the interrupt (for program interrupts) 
Vesotecsetveneuses ' 
32-33 Instruction length code, indicating the length, 
Usage: in halfwords, of the instruction bcing executed 


when a program interrupt occurred (unpredicatable 


This request will type out the contents of the old program status word 
for external interrupts). 


Sor the interrupt which caused DEBUG to he entered. E DEBUG was 
entered due to anexternal interrupt, the FSW ree wcst will cause the 
contents of the external old PSW to be typed at the terminal, Wa 
program interrupt caused DEBUG to be entercd, the contents of the 
program old PSW will be typed. If DEBUG was entexed fox any other 


34-35 Condition code, which reflects the result of a 
previous arithmetic, logical, or I/O operation, 


reason, the following will be typed in vesponse to the PSW request. 36-39 Program mask, indicating whether or not various 

y program exceptions are allowed to czuse program 
01000000xxxxxxxx interrupts. 

40-63 Instruction address, giving the location of the next 


where the 1 in the first lyyte means that external interrupts are allowed 


and xxxxxxxx is the hexadecinial core addrces of the DEGUG program. instruction to be executed (for program interrupts ) 


or of the instruction last executed (for external 
The fields of the programm status word are as follows: interrupts). 
For a further discussion of program status words and their use, refer 


Bits Contents 
Ties gee oad to IBM manual A22-6821, Principles of Operation. 


0-7 . System mask, indicating the sources which are 


allowed to intersupt the CPU, Responses: 


8-44 Protection key, used to determine if a given If the request has been correctly issued, the contents of the appropriate 
core Jocation may be written inte. ; program status word will be typed in hexadecimal representation at the 
terminal, followed by a carriage return and an unlocked keyboard. Sce 

42 ASCII flag, indicating whether ASCII-& or _ Figure 3. 3, 2-¥F for an example of response to the PSW request. : 


EBCDIC code is to be used. 
INVALID DEBUG REQUEST 


43 Machine check flag, which is set to 1 whenever This response indicates that the user has specificd one or more operands 
a machine check occurs, in the PSW request. Re-issuc the request in its correct format. 
14 Wait state flag, whichis set to 1 when the CPU 


is in the wait state rather than running. 











AIT "01/01/68 A 4} . 4 : , (01/01/68 
3.3.2 -32 } 8.3.2 -33 4, 
DEBUG os DEBUG 9 =") 
~ RESTART . RETURN 
RL ART ia . RETURN 
Format; Format: 
‘ie areas ’ ho pean 
RESTART 
Use ge: , : Usage: 


This request is a means of exiting from the Debug environment to the 
CMS command environment. It should be used only when DEBUG has 
been entered by issuing the DEBUG command. 


The RESTART request is intended for use when an error has been encountered 
which the user cannot or does not wish to correct, but when the user wishes to 
retain his current copy of the CMS nucleus and all currently defined symbols and 
breakpoints below hexadecimal core location 12000. Successtil execution of che 


, P ; When the RETURN request is issued, the general purpose registers are 
RESTART request will transfer the user from the Dehuy environment to the CMS a Y & purl & 


‘ ; restored with either the information they contained at the time DEBUG 
Comma! environnicnt. ; ; ; : ae “3 
was cntered or, if the user has specified a change to this information 
: eee Ady He ee : in Sale a hile in the Debug environment, with the changed information. In either 
Vhen-the RESTART request is issued, an attempt will be made to re-initialize the mass ; & é on B : ‘ i 
: fe ; ; ee : . ae : case, register 15, the error code register, will be set to zero. A branch 
CMS nucleus in core, i.e., without bringing in «@ new copy of the nucicus from. ae ‘ ; . ‘ ‘ 
me | uv PADD Gag ad P : Be oh is then made to the address contained in register 14, the normal CMS 
the system disk. When RESTART is issued the following will occur: (1) the origin ; SIRT ICS eae ee RIC 
TW be eck to: ; a a Nye ; ny ‘ return register. If DEBUG has been entered by issuing the DEBUG com- 
will be set to'0 (2) all breakpoints above hexadecimal core location 12000 will be : : , wart 
' . aaah dy F ASage. : eee mand, register 14 will contain the address of a central ChiS service 
cleared (3) all overrides will be cleared (4) the active file table wil! be ti f ceibrol will iransior Uluebtly toe CMS Commatd-onviron 
ai 22 A , : : . routine Ka COUT ¥ JC were iA ang ; ze 
cleared aud (5) the last uscx file directory written to disk will be brought in to neu ri an a y ; 
replace thatcurrently residing in core. men 


Ee errr } Sts Responses: 
IW RESTART cannot be successfully executed, i.e., ifno response is given to the bash acca) 


RESTART request and Wie keyboard reinains locked, the user may obtain a new R; T= xx. xx 
copy of CMS by hitting Uie attention key once and typing “IPL 190". ‘The Ready message, followed by a carriage return and an unlocked key- 


board, indicates that the RETURN request has been successfully executed 


Responses; and that control has transferred from the Debug environment to the CMS 
AP eae ‘Command environment. The xx. xx portion of the Ready mnessage gives 
re ; : sci the CPU time, ji mds, used while in the Debug environment. Ke 
This mesage, followed by a carriage return and an unlocked keyboard, indicates a we ey ace : b ae 1 ‘a 1 : 1 he sad . 
cn is messap typed, the keyboa ill be unlocked to accept any Cl 
that the RESTART request has been successfully executed, and that control has one ae sean eee! : eee, ee 
transferred from DEBUG to the CMS Command environment. xx. xx in the above BUENOS! 


messvec is Uie CPU time (in seconds) which has been used since the last CMS 
command was issued. 


INVALID DEBUG REQUEST 
This message will be piven if one or more operands have been specified 


ee in the RETURN request. Re-issue the request in its correct format. 
INVALID DEBUG REQUEST 


One or more operands have been specified in the RESTART request. Re-issue 


INCORRECT DEBUG EXIT 
the request in its correct format. 


If DEBUG had been entered due to a program or external interrupt or the 
encounter of a breakpoint o1 au unrecoverable error, this message will 
be typed in response to the RETURN request. To exit from the Debug 
environment under the above circumstances, issue cithcr the GO request 
with an operand, or the IPL or RNS'PART requests. ‘The GO request may 
be issued without an operand if DEBUG has not been entered due to an un- 
recoverable crror. 





nm. . 
01/01/68 / Zz, 
3.3.2 -34 01/01/68 iar 
DEBUG 3.3.2-35 
~ SET . | DEBUG 
, sey 
SET f 
fhe number of hytes which can be stored using the SET request varies depending 
Format: on the form of the request. With the CAW form, up to four bytes of information 
feta teint may be stored, With the CSW, GPR, and FSW forins of SET, up to eight bytes of 
osreseer ess ROO eens e Sees Moree res Ane as eee TAS : Lean may be stored, but these must be represented in two operands of four 
' H/CAW hexinfo ) ‘ byics each, Whenever two operands of information are sp2cificd, the information 
‘ SET i}CSW hexinfo — [hexinfo] Will be stored in consecutive locations, even if one or both opereznds contain less 
3 Psw hexinfo  [hexinfo] 7 than four bytes of information, as shown in Example h. 
' GPR reg hexinfo {hexinfo] } } - : 
' The contents of registers which have been changed using the SE’l request will net 
Sooeseocud= whe ween nnn wee wr ee eee en - be typed out after the request has heen issued. In order to inspect the contents 
=e : neers lw ot of these registers, the user should issue CAW, CSW, FSW, or GPR requests, as 
CAY indicates that the specified Information is to be necded. Figure 3,3.2-A contains examples of issuing these requests both before 
7 stored in the channel address word which existed and after the SE’ request has been issued. 
at the time DELUG was entered, ° 
Responses: 
CSW indicates that the specificd information is to be ean 
< : stored in the channel status word which existed If the request hus been issued correctly, a carriage return will be issued and the 
at the time DEBUG was entered. keyboard will be unlocked to accept another DEDUG request. 
PSW indicates that the specified information is to be . om INVALID DEBUG REQUEST . 
stored in the old program status word for the : this responst indicetes that the wrong number of operands have heen specified 
interrupt which caused DEBUG to be entered. in the SIP request. If the CAW is heing set, tvo operands rust be given, To set 
the CSW or the TSW, either two or three operands are required. ‘fo sect a GPR, 
GPR indicates that the specified information is Lo he either three or four operands must be given, 
stored in the ecncral purpose cogister piven its : 
the sccoad operand. INVALID AKGUMENT 
This message indicates that cither (4) the first operand is not CAW, CSW, PSW or 
Usace: GPR, (2) the first operand is GPR and the second operand is not a Cecinial mimber 
Sasa between 0 and 45 inclusive, or (3) one or more of the “hexinfo'' operands dogs not 
The SET request is used to change the contents of control and general purpese contain hexadecimal information. i 
registers which are moved from their normal] locations when the DEBUG environ- 
: ment is cntered. The contents of these registers will he restored when control Sxamples: 
transfers from DELUG to another environment; if the register contents have been Gras a 
modificd in DEBUG, the changed contents will be restored, ‘ae SET CAW 4400 
This example would cause the two-hytes '4400" to be placed in the first two bytes 
‘The register which is to be moMificd is specificd as the first operand of ihe SE of the channel address word which existed when DELUG was entered. See Figure 3.3,2-F, 
request, and the infosmation to be inserted in this register is given in hexadecinial This new channel address word will be restored when an exit is made froin the DEBUG 
format in the “bhexinfo' operand(s). Lach "hexinfo' operand should be from one to environment. 
four bytes (i.e., two te cight hexadecimal digits) in length. If an operand is less 
than four bytes in length and contains an uneven number of hexadecimal digits b. SET CSW 004 OOl'l'S4 
(representing half-byte information) the information will be, right-adjusted and Ui Since an urcven numner of bytes is specificd in the second operand, a zero will be 
left half of the uneven byte will be sect to 0, as shown in Example b. If more than placed in the left-most half-bytc, giving 0004. These two bytes, tosether with the 
eight hexadecimal digits are specified in a single operand, the information will be three bytes given in the sccond operand will be placed as a single five-byte ficld 
left-adjusted, and the additional digits will be truncated on the right and lost. : into the CSW which existed when DMBUG was entered. See Figure 3.3.2-F. This 
(Sco Exznple-d), ; . new channel status word will he restorcd when leaving the DEBUG environment. 
. ¢ 
ve ‘ 





we 


01/01/68 
gine /01/ 
DEBUG 


SET 


Ce SET P5W 041000000 000412036 

The contents of the entire program status word for the interrupt which caused 
DEBUG to be entered would be replaced by these eight bytes of information. See 
Figure 3,3.2-l,, This PSW would become the current PSW when an exit is made 
from the DEBUG enviromnent. 


d, SET GPR 5 000042345 
In this example, the contents of general purpose register 5 arc to be replaced by © 
the information given in the third operand. Since this information is greater than 
eight hexadecimal digits, it will be left-adjusted and the extra digits will be trun- 
cated on the riplit, giving 00001234. See Figure 3.3.2-I', General purpose register 
5 will contain this new information when the general purpose repisters are restored 
prior to leaving the DI:BUG environment. 


FIGURE 3,3,2-F. 


caw 
VOOLOFES 


set caw 1100 


caw 
LIOOOFES 


csv 
OOGLOFFSOCONG00S5 


set csw 001 OUFTS81 7 


csv 
QVUOLOOFFS1000005 


psw 
0100000000009588 


set. psw 010000U0 00012036 - 


psw 
0100000000012036 


apr 5 


OuU007F68 
set gpr 5 000012545 


gpr 5 
HVOO1LT2Z54& 


01/01/68 


3,3, 2-37 


DEBUG 





SET 


Examples of the SET request, using other requests 
as appropriate to inspect contents both before and after SI;T is issued. 


- 


2, 


oe 


wd 
Se 


STORE 


Foriaat: 


J03 
01/01/68 
3.3.2 3 
DEBUG 
STORI: 
Beret raas eon alarm “eae aaa a ae a a Coa PE En ee See ee Pee eae ‘ 
i + ( symbol ‘ ' 
4 STORE | y hexinfo {nexinto [hexins a 1 
: » = { hexloc ' 
heels bidet epee bn nib JR ee ue {eee aie cube e Rate aaa enn ' : 
symbol is a name assigned (using the DEV. request) to the core 
addvess at which the first byte of specified information 
is to be stored. 
a ¢€ 
hexloc is the hexadecimal Jocation @elative to the current 
origin) where the first byte of information is to be 
stored, 
hexinfo is any hexadecimal information, four bytes os less 


in length, which is to be stored starting at the address 
specificd by the first operand, 





This request allows the uscr to store information in any virtual core location. ‘The 
location st which the information is to be stored is specified by the first operand and 
is determined as follows: If the first operand contains any non-nuniexic characters, 
the DEBUG symbol table is setrched for a matching symbol entry. Ifa match is 
found, the core address to which that symbol] nance is assigned will be uscd as the 
address at which information is to be stored. If no match is found in the DEBUG 
symbol table, or if the first operand contuins only munexic characters, the current 
origin will be added to the specificd opexand and the resulting core address will he 
used, provided it is not greater than the use ‘'s virtual core size. 


The information to be stored must be given in hexadecimal format and is specified 

in the second through the fourth operands. Hach of these operands should be from 

one to four bytes (i.cs, two to cight hexadecimal digits) in length. If an operand is , 
less than four bytes in length and contains an uneven number of hexadecimal digits 
(representing half-byte information), the infoxmution will be xight-adjusted and. the 

left half of the uneven byte will be set to 0 as chown in Example b. If more than 

cight hexadecimal digits are specified in a single operand, the information will 

be left-adjusted, and the additional digits will be truncated on the right and lost. 

(Sce Example b.) 


f 
Bet 


01/01/68 
3.3.2 -39 


DEBUG 
STORIE 


A maxiinum of 42 bytcs may be stored at one time using the STORE. request. This 

is donc hy specifying three operands after the location ops rand, cech of which contain 
four bytes of information. Uf less than fous hytes are specified in any or all of the 
operands, the information given will be arranged into a string of consecutive hytcs, 
and that string will be storcd starting at the Jocation piven in the first operand, 
Stored information wil] not be typed out at the terminal. To inspect the changed 
contents of core after a STORE xequest, the user may issue an X request, as shown 
in Fipure 3,3, 2-G,. 


. Responses: 


If the xcquest has beea correctly issued, a carriage return will be given and the 
keyboard Will be unlocked to accept anothe’s DEBUG request. 


INVALID DERUG REQUEST 
"This response to the STORE sequest indicates that cither Jess than two or morc 
than four epexands have heen specified. Re-issue the request in its correct fornist. 


INVALID ARGUMENT : 
This message will le piven if either (1) the first operand cannot he located in the 
DEBUG symbol table and is nota valid hexadecimal number, ox (2) information 
specified in the second, third, and/or fourth operands is not in hexadecimal format. 
If the first operand is intended to be a symbol, a DEF request must have becn 
previously issued for that symbol; if not, the ope rand must specify a valid hoxa- 
decimal core location. 


INVALID CORE-ADDRESS ' 
The current origin value, when added to the hexadecimal number specified as the 
first operand, gives an address greater than the user's virtual core size. If the 
origin value is unknown, reset it to the desixed value using the ORIGIN request 
and then re-issue the S'TORE request. 


Exainples: 


a, STORE 12024 OACA : 
‘This will caus¢ the two bytes of information “OACA" to be stored at the core 
address obtained by adding the current origin to lucation 42024, See Figure 3.3.2-G, 





b. STORE XYZ 1344231567890 S5SCA14 B 

Since the sccond operand jn this example contains more than cight digits, it will be 
truncated on the right, giving 13442345. The third and fourth operands, containing 
an uneven number of digits, will become 05CA14 and OB respectively. This cight- 
byte string wil) then be stored in the core address indicated by symbol XYZ. Sec 
Figure 3.3. 2-G, 








. . 01/017 68 
3.3.2 -40 


DEBUG 
STORY 


Ce STORE 42 FRFFFFFF FEEPFEPE FORIE213 

This example would cause the maximum number of byics, 412, to be stored at 
location F412, If F412 is a pteviously-defined symbol, the information will be 

stored starting at the address to which that symbol refers. Jf no symbol F412 has 
been defined, the current origin will be added to the hexadecimal number F412, and 
the resulting address will be used as the starting address into which the information 
will be stored. See Figure 3. 3.2-G. 


- 91/01/68 AA 
3.3,2- 4] 
DEBUG. 


STORE 


x 12024 
CS06h0Cb 


store 12024 Uaca 


x 12024 
VACA OCG 


x xyz 15 


- D7NSCONECSHOLOSOFCNO0CS823F028 


store xyz 1341234567890 Scalhk bh 


x xyz 15 
L3H A234 505CALLORECNO0C9823F028 


x f12 13 
FLECH370A09LH1LAUAUU29T0FFO 


store 12 fFFFFF FPP fFerf Per furl fr2F3 


x f12 13 
EER ERREPPRPPPEE PEOPLE 26300, 


FIGURE 3.3, 26G. Examples of the STORE request, using the X 


request to inspect the contents both before and after storing. 


Se 


~ 


x 


01/01/68 
3.3.2 -42 
DEBUG 
xX 
Format: 
renee erence ee Beer ie ee ' 
8 1 
‘ ‘| symbol : ‘ 
‘ lengtix ’ 
1 i ' 

: xX } 
‘ { ' 
‘ hexloc 
| 4 i 
1 ‘ ms f] 
ne te we Dw wee me ee me ee ee mee 

symbol is a name assigned (using the DEF request) to the core’ 

address of the first byte to be examined. 
hexloc is the hexadecimal core location (clative to the currently- 
g defined origin) of the first byte to be examined, 
n is a decimal] number from ¢ to 56 inclusive, which specifics 
the number of bytes to be exaniined. 
length is the length attribute of the symbol specified as the first 


Usarc: 


operand, 


This request is uscd to examine the contents of specific locations in the user's 
virtual core, and will cause contents lo be typed cut at the terminal in hexa- 
decimal form. The first opcrand of the request specifies the beginning address 
af the portion of core to he examined. This address is determined as follows: 
if the operand contains any non-numeric characters, the DEBUG symbol table 

is searched for a matching symbol entry. If a match is found, the core address 
co which that symbol refers will be uscd as the Jocation of the first byte to be 
examined, Tfno match is found, or if the first operand contains anly numeric 
chacacters, the current origin (as established by the ORIGIN request) will be 
added to the specificd operand, and the resulting core address will be used as 
the location of the first byte to he examined, provided that address is not greater 
than the user's virtual core size. 


The second operand of the X request is optional. If specified, it indicates the 


number of bytes -- up to a maximum of 56 -- whose contents are to be typed out. 
if the second operand is omitted, a default value of 4 bytes will be assumed unless 
the first operand is a symbol; if itis, the length éttribute which is assigned to that 
symbol in the DEBUG symbol table will be used as the number of bytes to be typed 
out. . 


01/01/68 
—8,3,2-43 aed 
DEBUG 
~X 


Respouses: 


If the X request has been correctly issued, the information wil) be typed out and, 
following a carriage return, the keyboard will be unlocked to accept another DEBUG 
request. 


INVALID DEBUG REQUEST 
This response indicates that either no, or more two, operands have been specified 
inthe X request. Re-issue the request in its correct format. 


INVALTD ARGUMENT 
‘This message is given when either (1) the first operand cannot be Jocated in the 
DEBUG syinbol table and docs not constitute a valid hexadecimal nuinber ox (2) the 
second operand is not a decimal number between 1 and 56 inclusive. Hf the first 
operand is intended to he a symbol, it must have been defined in a previous DEF 
request; otherwise, the operand must specify a valid hexadecimal number. 


INVALID CORE-ADDRESS 
‘fhe hexadecimal number specificd in the first operand, when added to the current 
origin, is greater than the core size of the machine being used. If the curvent 
oxigin value is unknown, reset it to the desired value by issuing the ORIGIN request 
and then re-issue the X request. 


Examples: 


a. X XYZ 

The contents of core starting at the address to which symbo] XYZ is assigned will 
be typed out at the terininal. The number: of bytes typed will be determined by the 
length attribute of symbol XYZ as established in the DEF request for that symbol. 
Sce Fipure 3. 3. 2-H. 


b. X OTHER 12 
Twelve bytes of core will be typed out beginning with the core address to which 
symbol O'THER has been assigned in a previous DEF request. Sce Figure 3. 3. 2-H. 


Cc. X 123 : 

Since no byte count is specified, four bytcs of core will be typed out starting at the 
core address which is the sum of the current origin value and the hexadecimal 
number 123. Sec Figure 3. 3. 2-H. 


d. X 123 32 

Thirty-two bytes of core will be typed out, starting at the address which is the 
sum of the current origin value and the hexadecimal number 123. See Figure 
3. 3. 2-H. 
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DEBUG. 
x 
X KyZ 
00014020 
def other 120 . ‘ 


x Other 12 
DONS22021A08h0C5N5C42200 


x 123 
O2Z1A0440 


« 


x 125 32 soo , ‘ 
O2ZLTADLNOCEDSCHA2Z0000000UCODDOOLONDDDD 00000000000 0D00000000000KF 0000 


FIGURE 3, 3, 2-H. Examples of the X request. 
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3.3. 3-4 Via 
SETERR 
SETERR 
Purpose: 





The SETERR command is used to trace transfers to and from al] SVC- 
called prograins in which error conditions occur. 


- Format: 
ee eee oe ee ee ee a 
: i 
' { svrenn ' 
e 6 
Usage: 


The SHTERR command will ''set error" overrides which cause trace information 
to be recorded for all SVC-called programs that return with an error code in 
general purpose register 15. The following information will be recorded: 


(4) A basic line consisting of the core locations of the SVC instruction 
and of the program which it called, the contents of the SVC old program 
status word, and the core locations to which the SVC-called progsum 
would return under both normal and error conditions. 


(2) The contents of all general purpose registers, both before the SVC- 
called program is given contxol and after it issues a return. 


(3) The contents of all floating point registers both before the SVC~-called 
program is given control and after it issues a return. : 


(4) ‘Two lines, or 16 words, of the parameter Jist which cxists at the 
time the SVC is executed. See Fisure 3.3.3-A for a sample of the 
type of infomation which will be recorded by the 5: TERR command, 
and the format in which this information would be printed on the offline 
printer. ; 


The SETERR command will cause the above trace information to he 

recorded fox all SVC-called programs that return error codes, but 

this information wiJ) net be printed out until the user issues a CLROVER oF a KO 
command, issues a RESTART request in the Debug environment, or logs out froin 
the Control Prograin. 


’ Traces initiated by the SETERR cornrnand may be terminated by 


ea issuing a CLROVER or a KO command, Both CLROVER and KO, 


as noted, will cause the trace information recorded up to the time 
they are issued to be printed on the offline printer. | 
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3.3.44 


SETOVER 


Purpose: : 


The SETOVER command is used to trace transfers to and from SVC- 
called programs which are executed normally as well as those in which 
error conditions are encountered. 


Forynat: 


presses POT tees PS SG eee ie Ore eS i Rs eT em ere ae a ae 1 
{ seroven| [ sampcasr | [ option 1... optionN ] 
' - i a 
toe oi See meets a Se Se Ste re EM htt a oa ie 3 


a 
leaves all options ab set by the user's 
last SE‘TOVER command; if SAMELAST 
is not specified, the options will be resct 
to their default settines. Any options 
specified aftexs SAMELAST will replace 
these settings. 


SAMELAST 


option]... option N are one or moxe of the options given 





below 
Options: 
oe, = . . 

GPRS recosd the contents of the general purpose registers both before 
the SVG-calied program is piven control end after a return from 
that program is issued, 

GPRSB | record the contents of the general purpose registers only as they 

exist before the SVC-colled propram is given control. 

GPRSA) record the contents of the general purpose registexs only as they 
exist after a return is issucd froin the SVC-called program. 

The default option is that no general purpose register infor- 
mation will be recorded. 

FPRS record the contents of the floating point registers both before the 
SVC-callcd program is given control and after a return from that 
program is issued. 

FPRSB. record the contents of the floating point repisters only as they 

exist before the SVC-called program is given control, 

FPRSA record the contents of the floating point registers only as they 


exist after a return is issucd from the SVC-called program. 


Vhe defanlt option is thet no floating point register information 
will he recorded. 


aoe aaa 


8-16 -67 
3. 3. 4-2 
SETOVER 


NOPARM no parameter list information is to be recorded when 


a program is called by an SVC instruction. 


PARM1 record one line (8 words) of parameter list information 


when a program is called by an SVC instruction. 


The default option is that two lines (146 words) of the 
parameter list will be recorded when a program is 
aa called by an SVC instruction. 
NOWAIY’ no information is to be recorded when WAIT is called by 
an SVC, 
record the same information for GPR's, FPR's, and para- 
meter lists when WAIT is called as that recorded for all 
other SVC-called programs. 


WALTSAME i 


WAITS record one line (8 words) of the parameter list when WAIT 
is called. 
WAIT2 record two lines of the parameter list when WAIT is called. 
The default option is that no GPR, FPR, or parameter 
list information will be recorded when WAIT is called. ‘ 
~ “ = *f { 
on < i 
DEFAULT cancel all current settings and resect the options to their 2 
default settings. a ‘ 
Usage: 


The SE: TOVER command traces all internal branches which take place due to SVC, 
or supervisor call, instxuctions. The effect of the SETOVER command is to "set 
overrides" which will cause information to be recorded at the appropriate times. 
Both normal and error overrides, as discussed in Section 3.3.0, will be set by the 
SE’POVER command. 


The information that is recorded will vary, depending on the type of override. For 
both normal and error overrides, the core location of the calling SVC instruction 
and the name of the called program or routine will be recorded, as well as the 
contents of the SVC old program status word (i.e., that which was stored when 

the SVC was issucd) and the core locations of the normal and error returns from 
the called program. In addition to this basic line, error overrides will record 

the contents of the pencral purpose and floating point registers, before branching 
to the SVC-called program and aftex returning from it, and 16 words of the para- 
meter list which existed when the SVC was issued. (Parameter lists are discussed 
in Section 3.4.1,]), For normal-overrides, the additional Anforration will 


8-16-67 x57 


3.3.4-3 
STOVER 


depend upon the options, if any, specified hy the user in the SETOVER 
cainnmiand, If no options are specified, the default options will be uscd: no 
general purpose ox floating point reyister information, and 16 words of the 
parameter list will be recorded for ell routines except WAIT. Por WAIT 
only the basic line of infoxmation, common to both normal aud erxvor over- 
rides, will be recorded. When the user does specify oy ions, the default 
setlings are assumed initially, and options specified by the user will replace 
the appropriate dcfnidt settings. Lf the user specifics SAMELAST as his first 
option, the options Will remain as they were sect by the last SETOVER 
command issued during the terminal session, and any further epbions piven in the 
SEVOVIER command will replace these previously sct options. 


It is possible to issue two os more SEUTTOVIER commands before issuiue a 

KO or a CLROVER command. When additional SUTOVER commands ane 
issucd, the option settings will be adjusted to reflect Uiose specified in the 

most recent SETOVER command. If WATTSAME is not specified as the first 
option in these additional commands, the optious will be resect to their decault 
scttings, and oly Giose options specified by the user in the new SEVOVER com- 
mand will replace the default settings. 


To terminate overrides set by the SE'TOVIER commit, the user may issue 
a KO ora CLROVER commend, Both CLROVER and KO will cause all trace 
information recorded up to the poiai they are issued io be psinted on the 
offline printer, CLROVIR can be issued only when che keyboard is un- 
locked to accept input to the CMS Co:nmaind environment, To clear over- 
rides at avy othexy point in system processing, KO shovld be issued as 
described in Section 6.3.0. if a user issues a RESTAKT request to the 
Debug environment ox logs out freni the Control Program priox to 

clearing overrides set by issuing the SETOVER and/oi SETERR commands, 
the overrides will he cleared automatically and all recorded trace infor- 
mation will ha printcd on the offline printer, 





Notes: 


a Uf the SANE LAST option is specified, it must be the first option piven, 


b. If mutialiy exclusive options are specified, such as NOPARM aid PARMA, 
the last such option which appvars in the SETOVER command will he used. Far 
options Wich are not mutually exclusive - GPRS and GPRSA, for example - the 
logical combination of the opiious will be used (in this case, the option set by 
GPRS would be used, since it includes the GPRSA option). - 


ec. The member of lines of parameter list information + corded for calls to the 
WALT routire canaot excced that recorded for other rou.ines, i.c., the ''PARM" 
seiting Wil govern the "WALT" setting whenever the latter specifies the greater 
number of lines to be recorded. 
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sh TOVER 


Responses: 


Nonc. . 


QUID. oo P1ING NORMAL - AND ERROR-OVERRIDES TO PROVIDE 


A DYNAMIC ‘TRACE OF CMS (AND 0S) SVC-CALLS.. . 


‘This Message appears — in the offline printout of trace informetion at all 
points where STOVER commands were issued. 


Examples: 

a. STOVER. 

In addition to the*basic information recorded for both norma] and crror over- 
rides, the above example would cause the default iformeation (no peneral 
purpose ox floating point register information and two lincs of the parameter 
list) to be recorded for all normal overrides. For error overrides, the.con- 
tents of all general purpose and floating point registers would be recorded both 
before branching to the SVC-called program and after returning from it, as 
would two lines of the parameter list infomation. (A sample of tie type of 
jnformation which would he sccorded is given in Pigure 3.3. 4-A). 


b. SETOVER GPRSB FPRSA  NOPARM 

For all normal overrides, in addition to the basic information, this exainple 
would cause the contents of the general purpose registers to he recorded before 
the SVG-called program is given control, ‘and the contents of the floating point 
registers to be recorded after a return is issucd by that program. No para- 
metesx list information would be recorded. For calls to the WAIT routine, only 
the basic Jine of information would be recorded. ‘The same information would be 
recorded for error everxides as that given in Example a. Sce Figure 3. 3.4-A 
for a sample of the type of infomation which would be recorded for this example 
and the format in which i¢ would be printed. 


c. SETOVER SAMELAST PARM4 WAIT2 

Assuince Example b had been issued prior to this example. Since SAMELAST 

is specified as the first option, the settings for Example b would he assumed 

initially. The NOPARM sctting, however, would be replaced by the PARMt4 

option specified above. WAIT2 would normally replace the default option of recording 
no parameter list information fox calls to the WAIT routine, but since PARM1 has been 
specified, only one Jine of the parameter list for calls to WATT will be recorded. 

The sane information would be recorded for error oyerrides as that given in 
Example a. Refer to Figure 3.3.4-B for a sample of the type of information 

which would be recorded by this example and the format in which it would be 

printed, 
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YNCCINGS de t9000 Nowa wayyanaaa NDONgADD 
soonnaag plea Terareren anG0n 4)29A354 oo0010s3 


PO VAGIEG 

EOOCERFE 
Cae 

Traagsoaa 


orestaga 
ONAIVUsag 
NII ASS 
IIICOINA 
504 FEF 
49103000 


90000990 
F?VEACIE3 
ornangge 
99900090 
FFEE5830 
5032020438 





MACS 5D 
BHOCIOAG 


or -4 = —— -— 


wean 


--* 
2024587 9 27S805EF aN 









CALLEESTYPLIM — SYC-OLN=9 SUSFFOOR NAYES TSOC9NOARCC 
Nuoca39 grrsogoa aE 02000922 OoNOsace . 
yee coGae VIDICUNS acscaci7/ 4070A52A 09090990 
angagaag O9Gu0 904 abeareereled on90NA00 N29090000 


JLGCAG?3 CPIIOILE N95£4G F6LR1L 749 =< _— 


NRYRETENOONZIAE 
OOO LOCO 


CALLEFSRATT SV¥C= 
-~CCN 1-- ocasovedg 


-TLO-P SNe 


--cony 9000900 


SVCAME AD Se ond NIP 
ee ee nase 9G maf wi: Hoey 





STSCGSY20AF 


OCBY eo7n0000 
CALL CESAAIT Ae SVC=OL b= SW=F FOG NR MOE T<oqA NAF S 
VEGE NY STOOD AND 
faa ' 


O° 7700090 
20096006 


ALL: 

TOE OS Aas ae POUND Qe ras 
OPC eed DUIS Ils, “DIE ASIA 
pad ny us michnaee | 6) eee be ANQANANAD 
: BE aay D7NN0003 


YENOASDL 








roeet shosine £ tion recorded by the SETOVER 
"AEP2 specified. (SAMILAST in 


3. -4-A), 






PP tak ee 3 XN 
PALL aioe aang cay! 





oom aye os set in TIC 


nein ngeanae /Paneonese 00 ERRETHQMNN 


OA392 


Grr EE 


An nee meena 


UAAOLAS 


AIC 9-H EE 


29-9178 


ERRETHENCOOLE AS 


RB ET Een ee 


ERRETHONNINNT ING 


ERP ET=O900C1903 


ERRETS=OCQQNA2FS 


2979178 


ERR ET =0999A4292 


ERRET=CQOONLE 36 


EPRET=cocoazee ,' 


ERRET=0000C108 
ERRET =0000T1 C3 


ERRET= ONO0A2FS 


8-16 -67 
3.3.4-7 ae 
SETOVER 6777 


Error Messoxes: 

E(00001) ‘The user lias specified one or more invalid options. Re-issue ‘ 
the SETOVER command making sure that all options arc spelled 
corecetly aud that SAMELAS', if specificd, is the first option 
given. 


{ 
i 
{ 
; 
{ 
{ 
i 
! 





3.4.0 LANGUAGE PROCESSORS 


The language processors supported in CMS are the same ones used 
under the Operating Systern/360 (OS); these include Assembler (F), 
Fortran IV (G), and PL/I (¥F), 


The language processors in CMS and OS are compatible at the source 
language level as long as the BACKSPACE statement is not used in CMS 
Fortran and the inacros and SVC's used in an Assembler propram are 
supported by CMS. The object modules (text decks) that are output 
from the above Operating System compilers may be executed under 
either CMS or Of as long as the previous restrictions are adhercd to. 


The SNOROL compiler and assembler-interpreter are also included 
with CMS. They were adapted from programs designed to execute 
under OS, , 





the 


ASSEMFLE command 


ASSEMBLE 


creates relccatable 


Ercgrars written in’ System/3€0 Asscmbler Lan 


Formaet: 


-— = ee 


- er = 


PSSEYPLE Jraldenamed <...filenanwen>d<(cptiont... 


A | 


fileranre 


cpticn 


Cpticrs: 


SS aie 


it 
in 
te 

ix 


NOSECK 
Li51 


NCLLIST 


ire 
iexs 
Ion 
ine 


CARED 


tes 
jm 
Ia 
in 


NCELAG 


specifies 
Réditicnal filenancs 
acsemblies. 


ig 
Jisted helcw. 7 


creates a 1EX1 file cf the 
relecatable chiject Frceqram. 


suppresses the TEXT file. 


creates a LISTING file cf the 


eesembled prograne 
eLEpLesees the LISTING file 
ard online diagnostics. 


ircludes a cross-reference symbol 
table in the LISTING file. 
etippressas the ercss-reference 


syntel takle. 


types source staterent ccntaining ‘ 
creers at the terminal, along with 
diagnostic and errer messages. 


stppresses typing cf errere. 


cbject programs 
guage. 


optionn>) | 
I 


a SYSIN file to ke assenbled. 
specify additicnal 


che or wore of the assembler cyticns, 
t 


05/0. 
3.4.. 


hee 
fe “Fa 


i eP, 


from 


TERT 


‘ - 
2 : 05/01/69 
‘ 3.4.)-2 
ecg 
LIAEn writes the LISTING file cn the tare Jee 
wrose symbolic address is TAPn. gl: 
ILISK writes the LISTING file on 
the permanent disk. 
LBENTI writes the LISTING file on 
the offline printer. 
REND checks the pregram for re-entrance, 
DCERNT etppresses the re-entrance check. 
Sete: 
The filetype "SYSIN" is assumed for all input files te the 
ASSEMELE command. The file rust have fixed-length, #&0N-character 
reccrds. More than one assembly may be perferred Ly specifying 


adJitional fileranes, separated ky blanks. Any number of files may he 
epecified, but the command must not exceed a Single input Jine. ach 
file naned will Le asserbled separately in the crder named, 


ssembler cutput is centrelled by a 
crtion values selected, enclicsed in a set cof parentheses, fcllaws the 
last, cxrocnily, filename specified with the ccmmand,. One set of 
cpticns governs all] assemblies perfecrmed by one ASSEMELE command, The 
cpticns, specified in any crder, are separated hy at least cne blank. 
A jJefault valuc is supplicd fer any cpticn net included. The default 
cptacn values are; ; 


set cf opticns. The list cf 


DECK LIST XBEEF £LIAG NORENT LEISK 


Any combination of opftion values may he specified, but if NOLIST 


is included, XhEF, CIAG, LDISK, LPRINT, FERINT, and LTAFn will ha 
igncered. 
During an assembly, three .work files are created, with the 


filetypes SYSUT1, SYSUT2, and SYSUT3,. Their filenames are the same as 
the SY5SIN file heing aSsembkled.. Aceccrding te the options specified, 
files with filetypes LISTING and TEX may alsc te created, with the 
sane filenawes At the begirnming o£ cach asgsenbly, any pre-existing 
files with any of tne above filetypes and the current filenane are 
deleted, even if. the set cl epticns specified means they will not be 
replaced ty the current assemktly. ,To save cld cepies cf LISTING ana 
files, uee ALTER tc change c¢ither their filenames, or the 
filename ef the SYSIN file before assembly. Tusufficient space cn the 
permanent disk for any cf the assenbler files will cause termination. 
with an 1/0 erirer message. 


‘hilename TEXT FI" ais the file of machine-language cede cicated 


‘ 


B/OL/E° 
05/01/69 | bo 4 O5/01/ 


eee BS. .1-3 . 3.4.1-4 
by the assertblet This file can ke lowded for execution with the LOAD iB Bas ; Gi gee 
ev $ comrands, or punche? cut in object deck form cn the cardpunch’’” * Es SYNECLIC TAPE ALDRESS INCORRECT 
vitn the OFFLINE PUECH command. If NOVECK was epecified, this file is LISTI*G FILLE WILL EX WRITTEN ON DISK. WRITING 
‘tet created. _ ON TAPE IS CANCELLED. 


The cpticn value LTAn was specificd, and TAPn was not a valid 
sywkolic tape addreess The LISTING file is being written on the 
“Filenane LISTING E1"‘is the file cf source staterents and permanent disk. 
asezcatled machire ccde produced by the arsenbler. This file is not 
créstca if NKOLIST is specified. An external syktbol directory and a 


cicsse-Leference synrhol table are included, unless HOXREF was . C. OULTELG TAPE EULL. CHAKGE IY ARD HIT CARRIAGE RETURR. 
apecifired. Diacnestics and errer regsages appear at the botton of the An end-of-recl cerditicn wac detected cn the tape unit fer the 
LislinG fide, and, . unless HCDIAG vas specified, are typed at the LISTING file. The tape has keen reveund. Press the ATIN key to 
tecuinal. - 


enter the CP envirenment, and ask the oferator te meunt a new 
tape. Wher the cperatce replies that a nev tare is nounted, 
: , return to CKS with the ATTYN key, and type a carriace return, 
if PRINT cr LPRINT was specified, the LISTING file is printed on Ihc asserkly will resume where it was interrupted. 
the cftline printer. If LTAPn was specified, the LISTING file is 
britten cn the tape whose symbclic address is TAfn, in biccks ck ten 


Nal-character tecerds. If LDISK was specified, or if no value was 4. READY THE TALE UKIT ANL HIT CARRIAGE RETURN. 
specified, the- LISTING file is written on the permanent dick. The tape urit’ specified by LIT4Pn siqnalled not ready. Go to.cP 
with the ATTN Key and ask the operator to ready the unit. hen 
: : he replice that the unit is ready, return to CHS with the ATTN 
Ihe S¥YSUT1, SYsUT2, and Sysud3 files created hy the assembler and Key, and type a carriage return, The assembly will begin cr 
as@doas werk files are deleted at the end cf each acsonkly. Xf they resuKke. 


ete aot deletec because cf an abnermal terminaticn, they nay ka 
deleted with the FRASE command, or ky re-issuing the ASSEMBLE ccmmaitd. 


@e « PERYABERT Tv FERCE ON TALE 
LISTING FALE WILL BE WHITTON ON DISK. WRIPIKG 


ihe asserbler searches the system wmaerc lifkrary (SYSLYB MACLIB ON TAPE IS CARCEILFD. : 
Sy) for mracre Gefiniticne. Names of macres in this library ray he : All cr part cf& the asserbkly listing ig heing written con Gisk as 
Cttained with the HACLIB LISI ccwmand. Additicral wacro librarics may “tidename LISTING Po", If}any of the records vere succescfully 
Le created cn the permanent disk with the HACLIG GEN command, and up written cn the specified tape hefere the error, they vill he 
to tive of thesc additicral litraries Bay be included in the ausenhler missing £Erem the disk LISTING file. 


gfsarch list at one tire with the GLOBAL ASSEMBLER HACLIB cecwmand. 
User-defined litraries are searched befcre the systen library, and the 


dssembler accerts the first definition for a macro it finds, allowing f. PLEASE READY TUE PRINTER : ; 
tac uscr te cverride system macro definitions. If one of the user Ihis rcesejp,ense sheuld never cccur under CP. Netify the 
difcaries ain tke search list has the filenare "SYSLIB", the real respensible system pregranmer. 


systen library is not searched. See the MACLIB and GLOBAL ccmmands 
foc further infcreaticn. 
ge PERMANENT I/O EXRCR ON THE ERINTER, LISTING FILE 
WILL Ee WRITTEN CN CISKH. 


Aste? This respense shcuvuld never occur under CP. Netify the 
: reepensille systcn prograrrer. 
The errer completicn cede returned on tertination of an ASSENBLE~ 

ccmmand is the Fighcst severity code assigned by the assertler for any he PERMANENT I70 FRROR ON DISK, ASSEMBLY CONTINUES 

ex She assextiges perfersed by that cenmand. WITEOUT WRITING LISTING FILE GN LISK. 
The assenkly is completing without any LISTING file. Tf a 
listing if necegsary, execution nay be cancelled with the Ks 

fepcases? conmtuand. The error may have resulted fror insufficient space on 


the perwanent disk. Use the FRASE cecrmand to create more free 
Space, and try the assembly again. If the errer recuts, notify 
de ASSEPELING: r£ilenane the operatcr. 
This resyerse is typed fer the secend and subsequent assexblies 
ferfermed Ey a single command. lt separates diagnestics for the 
asscethlies. 





ieee 


3, 

la 

the errer corpletien cade returned on cerpletion of the ASSEMBLE oy 

command is the highest severity ccde returned by the assenbler.*“9 
for any of the assemblies performed ky that command. 


heferences: 


The Systen/360 ainstructicn set is descrihed in "Systen/360 
Frincirples of Operation", Porm A22-6821. The assenkler: 
instructicns and macro lanyuage are described in "Assembler 


Lanepage", | Form CZ6&-G514. Additicnal information on assembler 


executicn and nessages hay be found in "Assembler (F} 
Eregrarréer's Guide", Form C2¢€-3756. Note that the execution 
opticns in the “Froygrarnmer's Guide" are differene than these 


Supperted ty CKks. 


Ex3eeles: 


Mp 


Ae ASSEMELE RETURN 

The tile BETUKA SYSIN FI is assertled. Ro options are 
so the set cf default cpticns gceverng the assembly. 
fcllewing files are created: : 


specified, 
The 


RETUB?D LISTING F4 
RETURNS TEXT P4 


of this ccnnand, showing the 
generated hy the assembler. Figure 3.4.1-8 


See Figure 3.4.1-A for an cxanple 
cn-line diagnestics 


AMAL, 
4 “oe 


a 


showe the JISTING file created.” - 
Le ASSENILE KETURN JOA £ESTT (RENT LEBINT NOXREP 

NODLAC) 
the file "EEGTUAMN SYSTH FU" ais assembled, and the res sulting object 
code is checked £er ierenterability. The listing file is printed 
cut, and is net saved on disk. The Listina does not ccntain a 
Crese-rekerence sywhol table. On-line diagnostics are 
suppressed. URETURN TEXT FI" as created cn the permanent disk. 
When the asserbly is ccerpleted, the sane creraticons vill he 
rerformed for "JCBA SYSIN FS", and then for "TEST SYSIN PS". 


ErLor Messages: 


ASSEMELE UNDEFINED, 
were specified with the ASSENBLE command. 


£(00001) FILE(S) To 


Ne £ilenanes 


E(C0001) AT LEAST GNE OF THE FILES TO ASSEULLE DCESK*T EXIST 
Ch LGOESH YY EAVE A CCEPRECT "TYPE NAVE. 
acectblics were started. 
E(CCC01) AT LEAST ONE OF THE FILRS TO ASSEPELE HAS INCORRECT 


21-5 


cs 


"6404 


“The 


~~ 


05/01/69 
a, 3.4,1-6 
1) Ain Ps both 
7) é Lo v a“ 


80~character records. 


RECORD LENGTH. 
SYSIN filles must have fixed-length, 


E(CCCO4) 
Finer errors were detected during the asserbly, 
successful executicn cf the 


but 
Fregram is still prebable. 


E (C0008) 
Errors were detccted in the assenbled program, but 
execution may still ke possible. 


B(6C0 12) ; 
Sericus errers were detected in the assembled progran. 
Exccuticn is net probably. 


F(COC 16) . ‘ 
Very sericus erres were detected in 
rreqram. Execution is impossikle. 


the assenbled 


E(CCC20) PERMANENT J/C EBRCH WHILE REALING SYSIN 

UNAGELE TO ASSEMBLE ALL THE FILE. 

“Files specified befcre the cne namei in the message have 
been assembled. The file named and sukseguent cnes have 
net kecn agesenbled. The file in which the error occurred 
will have to be re-entered kefore assembling it. 


FILE filename 


Ile assembler detected a catastrephic error such that it 
ccvuld net ccontinue ficcessing. This may be an 1/0 error, 
catsed by insufilicient free space cn the perranent disk. 
Free scwe gface with the EKASE ccinmand, and retry the 
assembly. Ir the errox recurs, notify the operater. 


ASSEFELER LANGUAGE EHCGEANMING 


normal entry 
the file 
ky the 


rame of a 
file, 


point 
nane of the TEXT 
cctnand 


proqram should be the same as 
The program may then be executed 


$ filcnane 


Iz the filenare 
sequence 


and entry peint name 
mist Le used: 


are ditferent, the following 


LCAL filenane 





05/01/63 ‘ . Of /01/6% 
2.4.1-7 3.4,.1-0 
STAET entrynare Mee fEi; registers ere saved and re-stcred by the SvC-handling service fy ties 
: reutine, except register 15, which is used as an ergor return 77** 
register. ee ee 
Peg kit Fotnys 
Jhe fparareter list is always aligned on a doukle word koundary. 
whon centrel is received ry a user program, the address of the If a comnard is called, the same parameters that would he typed 
cutry peirnt is in register 15, twhich may be used for inrediate to call the command are placed in successive dcuble werds. Por 
saddpessability. Registe, UW centains a return address into the instance, @ parameter list ter FRASF wight appear as: 


wuS nuclets, and must ke saved. Register 13 centeins the address 
cL an Vu-werd save area. Register 1 points to a paraneter Jist, 


vhich ccntains any paraneters passed to the prograr by £ or PL1S1 ts or 

START. The parameter list is aliqned@ cn a double work boundary, pC CIE ERASE!’ 
aud each entry is found in the high-crder hytes af successive : rC  CLutet 

coubkle werts. All data jg in ECDIC. ‘The first entry is always [CC CL&'WORKFILE! 


the entry point name of the program being executed. : The 
fcellewing €utries arc the parameters passed to the program. For 


instance, after the command in this case, al] files with the filetype wWCRKFILE could be 
: ; : €rased dutanrg execution of the program hy the sequence: 
. £ JCEIC Sy7/66 21.37 7 
register 1 will point to a parameter Jist ain the follewing LA 1,PLIS% 
fortat: ; . SVC xXf*Cat 
FLIST cs co Aiter the files were deleted, CHS would return centrel te the 
ce cIe@tgcn1o0! . vext iustructicn atter the €VC. Register 15 would he set to zero 
rc CL8 95/7768! 7 tc indi¢gate that no crror occurred, Should an errer. occur, a 
DC CL8*71.37! reepone¢ weuld be typed and centro] pacsed te DEKUG. Paraneter 
Le extree lists ter: CsS routines which are net cernunds, such as EREUF or 
TYEFLIN, are not uniform. Complete explanaticns of these 
parameter lists may ke teund, in Secticn 232.4.1214 CNS Nucleus 
Tne last entry is always a double word with all bits set te che, Routines ard in the Cné Preqram Logic anual. 
d4nhich serves as a deliniter. Any parameters lenger than eight 


Characters are truncated to the eight high-crder charactors, 

; To avoid ccing tc CERUG whenever an errer cccurs in a called 
plogram, the prograrmol may specify an erroz return address with 
Ercye yn Feit: gach SVC. The address is placed in the four bytes immediately 
after the SVC. Centre) gocs to the address specified en any 
; €xror in the called ,icyrar. Fer exarples 

Return shetl@ always he ta the address received in register 14, 

lhis gives ccutrel te CHS s¢1vice reutines which close files, 


update the user's disk file directory, and calculate and type out LA 1, PIST 

the tire used in execution. CNS also inspects register 15 fer an ; Svc xX'cat 

arrer codes If nene is found, the cecmpletion nessage has the ; RC ALY (FREOUT) ; 
Lore “hk; Denenn/xe xX ¥X/XX/KX". Tf there is a value in register LH 2,726(1) 


15, the wessage ais "E(nnunn); Tenennyx.xx xxX/xXxX/XE" Where nnonnna 
is the errer code returned in reqister 15 on@ noun is the CKhS CPU 


time in secerds uscd fer executicn, x.xx is the CP and CHS CPU tote that the address cCensetant rust include a length 
tine, and xx7xxvxx is the time of day in heursyniyutes/sseconds. | epecificaticn ta prevent aligneent Ty the assenbler. In this 


Cxanple, if the called pregrar cempletes normally, control is 
returned at the LH instruction. If any errecr occurs, control 


lirkage te CHS Commands and Routines: gucs tc FREGUT. FErrers may Le ignored hy the sequence: 
whith few exeptions, all CUS linkages are made with one superviser SVC X'CAE 
call: SVC X'CAt. The address cf a farameter list is placed in CC ALU (#4U5 


tagister 1 before the call, and the first entry of the list 
always specifies the Ch&S ccmmand or functicn being called. All 


Iolo 
s 
- 





ches: | Tek 


a. Commanes that are net resident in the CNS nucleus may also he 
called py the CES SVC, but they will be leaded at hexadecimal 
location ZCCC. this if also the default load peint for wser 
programs, Oo a higher load point must te specified when the 
neseLrt's precran is beaded. A ccrplete list of the disk resident 
ceatands say be oktained with 4 LISTE * HOLULE SY, which alse 
Gives a ucugh idea cf the copmand give, expressed in B00-byte 
LOcords&. 


re. OA Sew OMS rentines way cnly be exceuted by branching. The 
nddiesecse Cf these proyrass are listed in a nucleus xedule under 
tne entry ‘peint SYSREr. SYSREF vill be rveselved as an EXTRN iu 
any user pregrar. The displacement from SYSKPE to the desired 
aldtess jf) chtaincd with the CKSYSHEP racre instruction, which 
yencrates jd cebries of ECU statements. , the name of each nruelecs 
reutine, with a "pe pretixed te it, 18 equated to its 
ligplacerert fren SYSREP in the address list. The following 
eaarple eldve hew te get te the SCAN vovutine ju the nucjeus. 


USERGCE | CSECT 
EXIRN SYSKEI 


L 3, =A (SYSREF) 
L 15, ESCAK (3) 
a: th AG 

Lok Sear (he) 

Bhe ruy? 


CHSYSHLE 


In the oxparcien cf Cnsyskur, DSCAN is equated to the 
displacement of the SCAN address in the SYSREF liste ‘The address 
is leadcd Jinto register 75 fe the BAIR. (SCAN is a routine to 
break up ia terminal linc image in cere into a standard CHS 
parareter Jist. Gee the CNS Pyegram Logic Manval.) 












Program 





3.4.4.4 Assert lyr Lausuage Progamming 


* 


Naini 





The normal entry point name of a program shonld be the same as the filename of 
the TEXT tile. The program may then be executed by the con:rnand 

§ filename 
If the filename and city point narsc eve different, the following sequence must 
he used: 


LOAD filename 
START cntrynamne 


Ae a 





CCR sopra, the address of the entry point is in 
ichusey be used for irumediate addressabiliiy. Regiscer 14 contains 
ondamust be saved. Revister 43 contains 

of on dheavord seve areca. Register 4 points to a parameter list, which 
conteins city paraieetan pessed to Gre progiiun by Sor SPARE, Vhe paaaocter 
Vist iss Ghizeiecl ona anne word boundery, end each cntry is found in the bigh-order 
auceessive double words. AGL datu is in EMCDIC. The first entry is 

of the programm being executed. The following cntrics 
For inst afier the conunand 


When seovatis is ive by a user 
royister a4, whi 
gs dngo the O83 nechous, 


aA yeturcn addres 


the addross 


bytes of 
always thojicutry point name 
aye the Poafanetors possess to the prograni. 


B JORIN5/7/08 24, 37 








Jnce, 





register J wil) poi toa parameter list in the following format: 
PLAS DS (1) 
DC CLSYossI0 
DC GUS 9/7/68" 
DE CL§'24.37' 
Bie 6A'EE! 


word with eH bits set to one, Which serves as a 
racteys are truncated to the eight 


Vhe Jasccutyy is elweys a double 
delimiter. Any parameters longer than cight cha 
hich-ordow charactors. 


Prog. Exits. 
oe Me 


be te the address received in register 14. This gives control 

which close files, update the user's disk file directory, 

and enlent we and ivpe cut the time used in cxecution. CMS siso inspects register 
45 for an crear code. If none is found, the compiction message has the form 

"Rs ‘Tenant. If there is a value in register 15, the message is "¢nnnnn); J 

Where nana is bbe crtox code returned in repister 15 and noun is the CPU tirne in 

WLIO. , 


Retirn shou Id always 
to CMS service routines 


seconds uckel for ox. 


T=p.nn' 


01-22-68 
3.4.1, 4-2 


JBU1T3 CSECT 
ENTRY JOw10 

JOB10 ae Ue 115 NORI4AT, ENTRY POINT, 

SING 9010, 12 ADDRUSSARILITY . 

: ie 18, REENSY SAVE CHS RETURN. 
LA 1,8(1) SKIP NAME PARAUMTER. 
rc 3,0(1) PICK UP CODE PARAIYITER, 
WREUP OPUT, BRROREERR2 
° ¢ 

ALLDON: 1 15, ERRCD GET ERROR Cobre, If ANY. 


1 Oe ee ee ee ee ere ee fee ee He Oe Oe ek Ok em et ee Oe ED Om Oe Ee 


Is 14, RUPNSV GET RETURN ADDRESS. 
BR ih BACK TO CMS. 
ERR 4 LA 15,7 
Si 15,URRKON Sue ERROW CODE. 
TYP TINCORRNCY CODE LUTTER, | 
R AVAGDONE 
ERR2 OT 15,uRROD SAVE WREUPF ERROR CODE. 
VYPI; TERROR WRITING,’ 
BR . ALDLDONI: 
; BRRCD nC Plot 
i Ri eaten DO r 
Figure 3.4.4.4-A. Samle entry and exit sequences in a veer 
progran, ais progrisa would he jo2opt on disk as . 
JOR1O WAY PS, and executed by thea coics ane 
£& JOB10 X, On entry, register 1 points to a 
paramater diet with the formats 
be CL8'JOB1I0' 
be CcLe'x! 


The exit sequence allows for two types of 
If the payvaweter supplied were not valid, 
following ‘vesponse would be typed: 


erroys. 
the 


INCORRECT CODM LETTER, 
H(GO0O7); T+0,02 


If an erxsor oceurred in WRLUF, the "ERROR WRITING" 
message would be typed, and the errer code would 
be that returned by WRBUE, 
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Linkage to CHS Comaands end Rowcines: Linkage Notcs: 

With fev exceptions, add. CMS Linkages are mage with one a. Conrands ery are net yvesident in the CHS mucleva may 
supexvisor call: Svc S'CA', «(The address Of @ pormester also he colied jor the Cis Sve, but they will be lenseod 
Lis t is placed jin reaqteter 1 before the call, end the at bonedeciual locetion 12000, thin as else the ée- 
first entry of the list always specifies the CMS command or favlt. load point for wsex proovanc, £0 cod 
fuiction being called. All registers are seved end re- point must be specified when tha user! 
stoxed by the SV¥C-handling service routine, except register 15, lLonded., A complete list of the disk xe 
wiich is used as an error retour register. ney be chteimed witch a LISS * oDULE ; 

gives a yough 3dea of the commend eta eaprauued in 
the pararater list is always aligned on a double word G800ehbyte records. 
boundasy. I£ a comuand is called, the same Parawrcers 
that. would be typed to call the comvaand are placed in bh. kK fer CES rowrines way only pe enching. 
Succes tive double words. Fox instance, a parancter list Who acdwesne. of thesa progres a nucleus 
for LRASE wight appear as; ; nodules tandeg the entry point e will be 


resolvad as en KeGan in ey ove. 


She diss 
PLST DS OD placmaont Cee SY BRM! to ti; e@ das : 


is 





dC CL8' ERASE! Gbtained with the Chevaree ycare wh, whies 
De CLEt*! generates a cexdcn of EQU stiutlenants of 
pe CLE'WORKEILE! erch nucleus voutdae, with a "Dp" pe ’ is 
r eavated 40 Lts ditulacewmunt Fyrom SYS mn tho eddrossa 
In this casa, @ll files with the filetype WORKFILE could lish. Une followstsa cr ie shoys ligw to Geb to the 
bo crarcd during execution af the program by the seaqucnces SCAN youtine in the nveleve 


LA V,Pnsye USERITOR Ch hod 


sve x*Cat EYRE GYSREY 
After the files vere coleted, CHS vould return control tu L 3,°R (SYSREY) 
the mext dnstruclion after the SVC. Register 15 would be L 15 ,DSCAU C3) 
set tO rere to indicate that no exrax occurred. Should an BALR 74,15 
Error occur, a recponss would de: tyred and control passed Lk 15,15 





to bebuG, Pareaweter lists for CMS voutines which are not LIT, PRRS 












co. = RDBUS or PYPLIN, exe not unifora. Complete . 
@np ‘antions “oF Chere poranater lists mey be found in the CHUSYSREE 
CHS Vrosram Logie Manual. ; . 

In the expansion of CESYSK DSCLN Ls coveted to the 
VO evoid going ta DEBUG whenever an error occurs in a displace 1 of the SCAN add Soin the SY Sry list. 
célicd progran, the pregrammer may specify en error xetusn Wana adde de deeded inte rewister 15 for the DAL. (SCAN 





acdress with each SVC. Whe address is placed in the four 
eas 3 diese chately after the SVC. Control goes to the 
specified on any error in the called program. For 


is a yoting lo breek up a termine! line image in core into a standard 
CMS parameter list. See the CMS Program Logie Meni. ) 


LA 1,PLS? ; 
SVC Xx CA! ‘ 

. pc AL! (ERROUT) 
Li 3,26(1) 


Bote that the address constant must include a length speci 
ficstion to pr cae alignment by the assembler, In this 
exavpla, if the called program completes normally, control 

is peturned at the LH instruction. If any eryor occuss, 
contol gous to ERROULT. kyrrors may be ignored by the Sequence: 


SVC x' Ca! 
bc ALY (4) 
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3.4.1.2-21 RAGE paae roekerance 


! ‘ mS BRACE Migs CHEGE © 3ee tadnG 
a bled Gis Bees OS : 39,/ CHSREG a Ba tbe $o27-7E 
; a ; ERASE 3.4.1. 2-14 
fhe meere definitions thet are used ie the Casbridee Honitor 7 “ pete tse eo 
Systen ere contained in the file SYSLIP NACLEB SY, vhich resides Vee 3 
cn the isyster Cisk and is called the nacro library. This TCDEY 3 
Jibvary centoing {1) CIS tacres thi linkages to the CHS REDBUE ; a 
t 
3 








ra bet 
4 
aa 
Rai 
@ 
a 


“yoke 
WG Bs: 


£ iC 
JyvyO reutines ena (2) “Systen 360 ¢ Syaten (OS) mecros SETUP 
vhich have .-hecn changed te interts CS. Gnly the CHS SuatE ’ Jot. 
bacrcs jaic discussed in this secticu aw discussion of thea OS beac 3 
hacrcs ‘which are surperted, refer +t tion 3.4.1.3. %o oktain TYEIS 3. 
alist of the arcs, £1i7e, and locat £ the necro definitious - bREUE 3 
in S¥SHXE LACLIB, the covsand "Nacri ish SYSLLB™ pay be issued. 
§eCpio ae ont the actuel vacre aetanitiene, refoxr to the procedure 
deserited in Seetica 3.1.10. 


fold 


Ce ae | 
fale ot ooh 


t 
cet 
~ 


> ef 
a 
aT 


& 
— 
a 
a 


the CHS macros described in this section deal prirarily uith 

linkay¢ bc the CNS digk and tervined hardling routines. TYPE and : ~ 
QYEIR handle fertinal I/C and CB, S¥YATE, SETUP, REDOE, WREUE, 

CKEGF, ERASE end Fints handle I/€ to the permanent eae the 

cetfling unit record @evices ray te accessed {rou an asserbler 

language peegram by calling tho CFrLine conmand, as eo egace 

undcr "Linkage to ClS Conmenés in Sectice 3e%.1.1.% 





‘The TYPE and YPIN rpacros Aon set uy a parameter List in line 
and isgue a ChS superviser cell. For disk Z7O, the fparaneter 
list ig set up in a censtant aad by the FC (Fite Control Block) 
racre, and the label of that tacre is used as a parapeter GE the 
KREUE,! REBUP, SETUP and SIALE Verna ae vhich issue CHS  SvYC 
instrudtions fer linkays.- If en existing fiJe is to ke read, 
STALE cand SERUP bust be eExacuted hefere the firgt ROEUF, to 
initialize the first File Centro] Bleck. Figure 4-4.7.2-h sheus a 
typical segucnee of sicrcs fcx writing and reading dist files. 





Netcs: 


a. The TYPE pnd UYPIN mecnes generate paraneter lists in line 

with executirg ccde. tf either Becro is ta he used repeatedly, 

it ray be were efficient te set up a single parameter List and 

issue ¢NS SVC's ta call the rovtincs directly. See Linkage to ‘ 

CYS Coumands and Keutines under Section 3.4.1.1. , : 


t. CS cleses vser files cn program cexpletion. A user nay have’ 
cniy & files cher at any given tine. If it “is necessary Lo use 
pore than & files, the EINIS nacre may be issved ta cClese scene 
tiles during peeqran executions The CHS nacres discussed in this 
‘gecticn are Jisted belov in alphakctical crdex. : 





04-22-68 B37. : 
3.4, 4,263 : 01-22-68  22/ 
CMS MACROS : . : . 3.4,4,2-4 
SG ' FCB 
FCB | 
fFIQUE DE 
STMT SOURCE STATEMENT _ Purpose: 
1 BEGIN CSECT 
2 PRINT NOGEN the VCB macro generates a CMS File Control Block , Which serves 
3 BALR 12, 0 ESTABLISH ADDRESSABILITY. as a parameter list,naming and describing ores files for the 
4 USING *,12 CMS I/O POU SNH ; 
5 STATE S{NPUT, ERR1I INITIALIZE INPUT 
9 SETUP [MPUT FILE CONTROL BLOCK Porinat.: 
15-RD- RDSUF INPUT,ERRORSEOF READ A RECORD, : 
20 ; WROUF OUTPUT, ERRORSERR2 WRITE SAME. (Nie ee tee aaa eee Rane er occ yo Rao eerie ay 
25 B RD REPEAT TO END. 1 label; FCH; (filename, filetype) ,area | 
26 EOF CKEOF ERRZ REALLY EOF? aa a aa naa Bs aa aces 
23 SR 15,45 a YES, CLEAR ERROR RETURN, 
30 DONS BR 14 ‘ RETURM TO CMS. . , 
31 ERRL TYPE 'ELILE NOT FOUND! label. — is a.statement label of seven or fewer 
&5 ERRET LA 15,1 INDICATE ERROR RETURN, characters, 
&6 B NOME 
47 ERR2 TYPF TERROR WRITING! (filename,filetype) specify the name and type of the file, 
61 8 FPPRET ; , : Mode F5 is assumed. 
° 62 ERR3 TYPE TERROR READING! . 
76 i ERRET area is the Label. of the input or output 
77 INPUT FOB (FILE1,DCL), BUFFI area in the program. ; 
95 OUTPUT FC3 CFILE2, NCL), BUFF I 
113 BUFF DS  CL80 vooger 
114 END BEGIN 
115 ECL8!RDOBUE! A File Control Block is needed for each disk file referenced in 
116 . NCL sg! WRBUF . a program. The label assigned to the FCB macro serves as a 
117 : eFfyo! ¢ parameter of the SETUP, RDBUF, and WRBUF macros, and the FCB label 
$ ATR with an "S" prefixed is a parameter of the SVATE macro, 
Pigure 3.4.4,2-A. An example of CHS I/O macros in an as'senibtety Before the FCB can be used for input files, the STATE and SETUP 
language program, This program copies the file PILE] DCL P5, macros must be executed. No initialization is needed for output 
and assigns the new copy the identifiers FILE2 pch P5. The files which are being created. ; . 
STATE ond SETUP macros: are excuted for the existing file to 
initialize the File Control Block. These are not needed for Included in the parameter list generated by FCB is an “item number" 
the output file, since it is being created. The program then field. whis specifies which record of the file is being referenced. 
alternates reading and writing records, until the RDBUF at If not changed, records will be read sequentially from first to 
Statement 15 returns the end-of-file error code. Control then last, and written sequentially in order. Records are added to 
goes to the CKEOF at statement 26, which tests whether end-of-fil the end of emisting files. However, if a number is specified 
or some other error has occurred. If it is end-of-file, the . in the item number field, the ite specified is read or written, 
error return register is cleared, and control returned to Bib Field is a half word at ROBB UES Ss where "LABEL" is the 
CHS vin Register 14. If an error occurs, an appropriate FeepOnee FCB statement Jabel. 
is typed out, an@ a value is placed in Register 15 to indicate 
to CMS that an error condition exists. In any case, CMS Examples: . 


closes both files when the provram is completed, 
ae INPUT FCB (INFILE ,DATA) , BUFF 
Expansion of this macro generates a parameter list referencing 
INPILE DATA P5, Before a RDBUF macro can use this FCB for 
“nput, the following sequence must be executed: 
STALE SINPULT ,ERROR 
SETUP INPUT 
No initialization would he needed for output. Data will be read 
into the area labelled BUFF, unless a different area is specified 
with RDRUF, 





01-22-68 . 
3.4.4.2+5 
STATE 355" 


STATE 
Purpose: 


Whe STATE macro provides linkage to a CMS routine which searches 
the user's permanent disk directory for a specified file. 


Format: 


label is an optional statement label. 

Sfcblabel ~ ds the label of the FCB being referenced, 
with an "S" prefixed to it. 
is the lebel of a routine to handle an 


error 
; error return. 


Se0Gs 


{ STATE should be executed before any existing file is veferenced 
for input or output. STATE places the directory eddress of the 
specified file in the FCB, From this entry, SETUP will initialize 
the FCB. 


If the file specified is net found in the user's file directory, 
STATE returns control at the point specified by the second parameter 
Notes 


STATE is not needed for files which are being created. 


a. ENTER STATE SA17,ERROUT 
This will cause a search of the permanent file directory for the file 
described by the FCB macro whose label ig AlL7. If it is found, 


the address will be filled in the FCB, if not control will go to 
ERROUT. : 


oo 
01-22-68 , 
3.4.1.2-6 237 
S'TUP 


SETUP 
Purpose: 
SETUP initializes the FCB with information from the user's permanent 


file directory. 


Format: 
pueeewasemoneraweceadnes 
' label . SETUP ' feb |} 
eee ee wet tee mk ne Oi) MY OOP Cee Oy OOS SanD Sa OED Ga BF I Oe OH ] 
label y is an optional statement label. 
fcb is the label of the FCB to be initialized. 
Usage: 


SETUP is executed following STATE to initialize the FCB. Record 
length and record format (fixed or variable length) are filled in. 
SETUP should not be executed if STATE returns with an error code 
in Register 15, indicating the file was not found in the directory. 


Example: 


a. SETUP A17 ‘ 
This initializes the File Control Block which has been generated by the macro: 


Al7 FCB (NAME,TYPL) ,BUFFER 































01-22-68 Bhi , 04-22-68 
es 4,4,2+7 ; 3.4,4.2-8 
RDBUT Solo ; RDBUF yy 

Rr Mera srg Peet Rk kk hat ek ee h9 P Ome we ars oe en oan eae ay ; 
: ; wate tO ew tw a te ne A ny 
3.504 RDBUE | Code ' Meaning : a 
[amir ene eee tne ae ee te tt 
Purpose: i 0 . no exror : 
| = 1 . file type not found ' 
RDDUF is used to read a record from a disk file. i 2 op uffer area not in core 
22 ats sk error t 
Format: b.8 ‘leqal mode letter : 
Te 5 item number is 0 ' 

ne a tn me ae ee a nt at ae nt oe : 6 no care available 
fe : 1 ‘ : ra I. €. eS t 
fkaboldnno0t] fon [paninead shes) Lanson-oiabell | iy file Ret in correct format || 
i 8 buffers [OO small (t#uncated item) | 
. ; 9 file ope for wirithng { 
label is an optional statement label. foAg eight filds lready I 
. nae t il incorrect mamborfof items 1 
feb . ; is the label of the FC8 naming the file : 12 ° end-of-file . ‘ 
to be reed. 1 13 mode niniber 3 H 
i Wee an we re ten Om ene me are ah AE OF 0 nO 8 MEE ee Hed eH tee che ne fol Bah ms emesis ot ame ere coe nus pone Ny ne nes Uh am ne con a fw sae test cee eres aoe 09 00 ome oe me | 
alabel is the label of an input buffer. If Figure 3, 4,4.2-B. RDBUF error retuy 2 Returned in 


omitted, the araa specified in the FCB 


sofetoy 45. 
is used, register 15. 


Example: 











elabel . is the entry of an error-handling routine. 
If omitted, errors (including end-of-file) a. READA RDBUF INPIL,AREA=RBUF /ERROR=EOF 
are ignoved. NEXT . 
Usage: ; : uO ; B READA 
: EOor CREOF ERREAD 
RDBUF returns one item each time it is executed. The item returned pe tg 
is spocified by the item number field of the Pile Control Block 
at FCOR+26. This number is incremented each time RDRUF is BUF ns CL8O 
executed. It may be set to any velue, allowing direct access INFIL FCB (ELIGR DATA) , BUF ; : 
to files, Assuming that the RDIAIE macro was preceded by a STATE SINFIL and 
a Sure INF, thisAsequence reads successive items\from the 
The file read may heve either fixed or variable length records, but file -FLIPR DATA P5 Items are placed in BUF, and cdntrol returned 
the buffer named ARSA= must be large enough for the longest at NEXT. When end-of-file is reached, control goes to Eor, where | 
yecord in the file. The buffer namad with ROBMUFP will override CREOP checks for/a 12 in register 15. If any other lue is in 
that specified in FcbB, if it is different. register 15, control will go-to ERREAD. 


Fach time RDBEE js exceuted, it links via a GMS SVC instruction toa routing 
which will return control when the record requested has been read in. If no 
error has occurred, register 15 is set to zere on return, ffan error, or end- 
of-file, occurs, register 15 will contain a code indicatiog the type of error. Sce 
Figure 3.4. 4.2-B for a list of RDBUF crror returns. If the ERRORs was supplied, 
control goes to'that point onan error. Hf no label was supplied, contro} returns 
inaacdiately follosing RDBUL, regardless of error. Note thar cnd-of-file is 
always considered an error, An error handling routine should start with the 
CKEOP macro, to detect end-of- file. 
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3.4.1.2-9 7p? 3.4.1.2 10 
EOL z WRBUR o,f ets 
SESE 39, NSS 343 3 
CKEOF , WRBUF 
Pures : Parpore 
The CKEOF macro checks the return code from RNLUF for the The WRBUF macro is used to create, update, or expand disk files. 
end-of-file indication. Any other value is considered an error. 
Format: 
. Format: 
eee Vy pn oye IP wees Hoe Get hs ee aw ee eee 7 pecs SRE Rea nre—s | 
we enna geen nnn eee ee flabe1]: wRBUFi feb [,AREA=alabel] [ERROR=elabelj! 
| label 'CKEOF 'erlabel | Low---2i-~----1------~~ it RETR Ac Ane a eA 
| RR a Se eee | 
label is an optional statement label. 
label is a statement label. St hs : ate : 
7 . Ech . is a label referencing the FCB 
erlabel specifies an error-handling routine. describing the output file. 
, alabel is the label of an area from which 
Usage: data is to be written. 
cnet sever Maar 
The label of the CKEOF macro is normally the ERROR= parameter elabel is the label of an error-handling 
of the RDBUF macro. CKEOF checks for a value of 12 in register routine. 
15, indicating end-of-file. If any other value is present (including 
zero), CKEOF branches to the specificd error routine. | Usage: 
Example: neaBUF normally is used to create a new sequential file, or 


to add to the cnd of an existing file. Nowever, any record 
RDBUP A17,ERROR=DONE of an existing fixed-length record file may be replaced by 
adjusting the item number’ field at FCB#26. 


DONE CKEOF ERRR : The AREA= parameter may be omitted with WRRUF if specified in 
CONT. the FCB. If specified in both places, WRRUPF takes precedence. 
ERRR TYPE ‘ERROR READING Al7' Control is normally returned with register 15 set to zero, 
BR 14 indicating error-free completion. If an erxor occurs, register 
15 will contain a code indicating the nature of the error, 
This sequence of instructions gives control to CKEOF whenenver and control will be returned wherever specified by the ERROR= 
register 15 is non-zero on return from RDBUF, If the error paramater. If no ERROR= is included, errors-are ignored, 
return indicates end-of-file, exccution continues with CONT. See Figure 3.4.1.2-C for a list of WRBUF crroxr returns. ' 
If some other error has occurred, CKEOF branches to ERRR, 
where a response is typed, and control returned to CMS. Note Example: , 


that the value in register 15 will be typed by CMS only if 
it is saved and restored around the TYPE macro. If this is done a. WRBUP A17,AREA=ITEM, FRROR=QUIT 
register 15 will be displayed in the error completion response: 


E(nnnnn); T=n.nn 7 QUIT BR 14 


‘LTEM DS CL80 

Al7 FCB (INTR, IBY) ,- BUFF] 
This sequence writes successive items into INTR JRH P5. On 
any error, control goes to QUIT, which returns to CMS, The error 
' vie will be printed in the CMS error completion response. 


-—- ‘ 








ee ee eee ee one ee ee ee ee et ee ce 


Figure 3.4.1.2-B. RDBUF error return codes. Returned in 


INFIL 


ae Ue aie ame gm Se Seer SE ee SD Gem ET OS UP rem ET SS EE tee SY SEE ee See ET SED ieee SET! Se GND een em PR ER es oy Oe SD Ge ee SE ee ee en gee pees we Oe ee 
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3.4.1.2-8 
RDBUF 


SOR me ree RO ret ANE SEE CNT GN CTE RN ENE Gree MD CU Mee ee ERED SHEE WIRY CONE GREE ER Gene GT Sen es Ge SS ED GS SEP GE SEE eter GRE OED Ce aw Gee GERD Ry own en Core Gone MES Sm oe oe 


no error 
file type not found 
buffer area not in core 
Gisk error 

illegal mode letter 
item number is 0 

no core available 
file not in correct format 
buffer too small (truncated iter 
file open for writing 

incorrect number of items 
end-of—file 

mode number invalid 


ee cune maP ST eneD nome STR cee SO CFS ED OSS SES Se SE Gee SE NE NT eee Ce BE ee ee ee ee es me I Oe ee Se EE ee os ee EE ee Ge oe Gee eet eee oes Oe ee oo 


SARE chet me eee eee EY mtRIERD ieee SE SE Ae OD OD GY ETT EP OD GA ONY FEED Geel GEE CO Ge enw een te 


register 15. 


RDBUF INFIL, AREA=BUF, ERROR=EOF 


B READA 
CKEOF ERREAD 





tJ 


DS CL80 
FCB (ELIPR, DATA), BUF 


Assuming that the RDBUF macro was preceded by a STATE SINFIL and 

a SETUP INFIL, this sequence reads successive items the 

file ELIPR DATA P5. Items are placed in BUF, and control returned 
at NEXT, When end-of-file is reached, control goes to EOF, where 
CKEOF checks for a 12 in register 15. If any other value is in 


register 15, 


control -will go to ERREAD, 


6—15-—70 





3.4.1.2-11 
WRBUF 
Code Meaning ! 
| tr a + 
{ | 
1 | 
O no errors 
1 filename missing 
2 buffer area not in core 
3 disk error 
4 illegal mode letter 
! 5 illegal mode number I 
| 6 no core available | 
1 F skipping variable item I 
8 length not specified 
9 file open for reading 
iL fixed or variable not set 
12 mode SY illegal 
13 disk is full 
; 14 read-only file : 
15 item wrong length 
! 16 F-V changed 
17 65K length limit on item 
18 | no. items more than 1 for V-format ! 
i 19 no. items equal zero 


Figure 3.4.1.2-C. WRBUF return codes. Returned in register 15. 
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Lng 
not in core 

















12 letter 


illee mode numboaxy 
noc vallable 


griable item 
weceified 
eading 
eight files alr dy open 
fixed or variablaNnot se 
mode S¥ illegal 
disk is €ul] 
read-only file 
item wrong length 
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16 ~ P-V changed 
17 GSK length limit on item 







» ay r. 
i8 no, it 3 More than 1 for V-foxrmat 
19 i, no. items equal “vero 
ee me cee et ee Oe oe ie Ri RT ene ee SR Gee SD ne AE en MM Hm at WA OWN RO rae Ae re mM te Oe iw a Hae nm Mi EM AO er ew SO OE Hi? er hE Ne ed Be fe He Bi 
3 Ce . vegas . 
Figure 3.3.1.29C, WRBUF return cof¢es, Returned in register 
15. 
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3,4.4.2-42 7 
ERASE 34S 


ERASE 


Purpose: 
The ERASE macro provides linkage to the ERASE command, which will erase the 
specified file from the user's permenent disk. 


toe 
gor ee Te cal ET Se ee ays i 
t {label} 1 ERASED 1 fed 
Re te kant Meo ee td flees eke Seas a a 
Jahbel igs an optional statement label. 
feb is the Jabel of the FCB which identifies the file 


to be erased. 





‘The BRASH macro allows the user to erase any file on his permanent cisk which 
has a filemode of Ps. 


Notes: | 
a. To erase a disk file which has e filemode other than PS, the user may sct 
up a@ parametes list and cajl the PRASE command directly, ag explained 
AS Commands in Section 3.4.4.4, 





under Linke to C 





}example: 
ae -BRASE INPUT 
The permanent disk file identified by the CB labeled INPUT would be erased. 
For cxample, if the macro 
, INPUP FC3  QNEILE, DATA), BUFF 
had been issued, file INIILE DATA P5 would be erased. 


04-22-68 
3.4.4. 2-13 


FINS 34 


FINIS 





the FINIS macro provides linkage to the FINS command, which wiJl close the 
specified user file, clearing its entry from the active file table. 


Format: 
feet eee oer irae en Tied 4 _ Bre ty on ae : 
H [label} oo: FINIS (| ich 
‘ We rts eae oh 
label is an optional statement label. 
fcb is the label of the FCB naming the file to be closed. 
LIsayet 


disk file identific 2 FCB whose 
‘The FINIS macro will close the permanent disk file identified nee ieee eh 
un iXde re t oa WSs ode Ae WV : 1k file 2 2 
label ig given as an operand of the macro. Since CMS allows only 8 
abel. ~~ wha dae 1 J 


j Cc 44" j nf wert ital + access 
at Senne this macro must be issucd whenever it is necessary to acces 
OPA a G Tr, S Fie 


§ files ina single user program. 
more than 8 files in a singic user prograi 


mpleti is rnecessar 
The CMS closes files automatically at program completion. It is se es ie 
- freee, aon x : oy ae : 
. use the FINIS macro, therefore, when oue progyam accesses mo 





FINIS INPUT . mee 

is The ee disk file identified by the FCB labeled INPUT would be closed 
Tor exanple, if tie macro ¢ 

hickiiae INPUT FCB (NFILE, DATA), BUFF 


had been issued, file INPILE DATA P35 would be closed. 





4 he 

are 
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3.4.4,2-44 
TY PIE 


es came 


TYPE 


Purpose: 


TYPE generates a parameter list and issues a 


; CMS supervisor 
call to type a line of termine] output, 


Format: 


U 


Se Bh botoct eo Lose 
H  [imessaget H P 
ilabed) i typ fo 
H rican i 
1 | ' length { 
boos s to oh in a ae ec wee nn a oe einer eters Cad 
label is an optional statement label, 


‘message! is the messaye to be typed, 





msglabel is the label of an area where the 
message to be typed is located, 
(r) is a register containing the length 
- Of the message area. 
n . is a self-defining tern giving the 
jength of the message arca, 
length is the label of a full or half word 


constant conteining the length of the 
jWessage areca. 


Bade: 


The maximum message-length is 130 characters, 
message is specified in single quote marks vith the macro, 
the length parameter is not used. If the label of an output 
arca is specified instead of the message itself, the Length 
must be included, Length may be specified as a self-defining 


If the actual 


term (a decimal nusaber or an equated symbol), or as the label 

of a full ox half word constant, containing the length. If 

length will not be known until exccution tine, a register containing 
the Jength may be specified in parentheses, 





01-22-68 
3.4. A. 2°45 


Notes: 


a. Issuing a TYP}. macro which specifies the messoge to be typed in single 
quotes is equivalent to issuing a CMSTYPE macro specifying the same 
message. 


. 


b. The GEN macro is included in SYSLIB MACLIB for use by the TYPE macro, 
and jis not meaningful for vse in a user program. 


Examp les 


a. ERRI TYPE ‘ERROR WHILE READING! #3 
The message ERROR WHILE READING is typed out at the terminal. 


b, TYPE MSG,LTH 
MSG pc C'EXECUTION BEGINS...' 
LTH EQU *-MSG 


The mesoage EXECUTION BEGINS... is typed out. 


ris 3% 
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ANG), 
TYPIN ce 
Purpose: 
TYPIN reads a line of input from the terminal. 
Format: 
[abel] | iTYPIN | area [, Leagt ch| [, EDhe}. | 
label is an optional statement label. 
area is the label of a 130~character input 
buffer. 
length ° is an optienal label to be assigned 


to a three-byte field of the parameter 
list where the number of characters 
road is placed. 


.c is a one-~character code specifying the 
editing of the input line to be performed 
by CMS before returning control. If omitted, 
Ut is assumed. 


Editing Codes 


u interpret delete characters, trams’tre to 
; upper case, pad with blanks to 130 
characters. : 
Vv interpret delete characters, translate i 
to upper case, i 
s interpret delete characters, pad with 
blanks to 130 characters. 
wy interpret delete characters. 
x Go not edit the line. 


Daages. 


TYPIN generates a parametcr list and issues a CMS supervisor 
eall to read in a line from the terminal. The input area 
specified must be 130 characters long. The number of characters 
read is filled into a three-byte area in the parameter list. 
This number may be accessed by specifying a label as the second 
parameter of the macro. ‘this number is always the number of 
characters read, whether the record has heen padded to 130 
characters with blanks or not. 


01-22-68 


01-22-68 
TYPIN 350 | Se ee 
; ; oe : CG. kEG 
The, ED= parameter allows the user to sclect which of the CMS editing functions 
are to be performed on the line. The delete characters (@and ¢ ) have their Purpose: 
normal CMS meaning if U, V, S, or Tis specified. Alphabetic data is translated ares 
to upper case if U or V is specified. The buffer area following the characters - ‘The CMSREG inacro-instxuction equates symbolic names to general purpose 
yead will be set to blanks (hex '40') if U or S is specified. The X option returns registers and floating point registers. 
the line exactly as it was typed. U is tlic default option. 
Format: 
Note: oR Tne ee eee eae ’ 
+s, ‘ eis. CMSREG 
a. The "number of bytes read" field is in the low-order three bytes of a full Tene a eed eek Rea a ya) ' 
word. For example, if the label specified is LAB, the number may be obtained 
by a LOAD HALF instruction from LAB + 4. Usaea: :. 
Exomple: : , The CMSREG macro-instruction equates the following symbolic names to the 
; . : , corresponding general purpose and floating point registers. This allows the 
oF ot XT ae % a : symbolic names to be used in place of the register designations. 
: General Purpose Registers 
BUFF 1 DS CL130 : RO EQU 0 
This sequence reads a line from the terminal into BUFF1. Since no ED= option Ri EQU 1 
is specified, Uis assumed. Delete characters will be interpreted (and the R2 EQU 2 
lengti: adjusted), lower case letters will be translated to upper case, and the R3 EQU 3 
buffer behind the line will be sct to blanks before control is returned at NEXT. R4 EQU 4 
The LH instruction places the number of characters read into Register 2. RS EQU 5 
R6 EQU 6 = 
b. GET TYPIN B, ED=X ; R7 EQU 7 
, R& EQU 8 
: : R9 EQU 9 
B DS 33R R40 EQU 10 
R44. EQU 14 
This macro reads a terminal line into B, The X option means no editing will be R12. EQU 12 
om 7 ey hh i 
performed on the line. Ri3. EQU 13 


Ri4. EQU 14 
R15 EQU 15 


Floating Point Registers 


FRO EQU 0 

FR2 EQU 2 

FR4 EQU 4 

: : FR6 EQU 6 
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3.4.4,.2-49 

CMSYSRET 

Tb ob~ 
CMSYSREF 
Purpose: 


The CMSYSREF macro allows users to branch to routines in the CMS mcleus 
which cannot he called by CMS SVC's. 


Format 
cerca Sylar eee es as tel a aay 1 
: CMSYSREF " 
t : ty 
Usage: 


sd 
The CMS¥SREF inacro instruction generates a series of EQU statements which 
provide the addresses of various CMS nucleus routines not available via a super- 
visor call, The addresses of these routines are listed in a nucleus module whose 
entry point is SYSRIEF, The name of each nucleus routine, with a "D"’ prefixed 
to it, is equated to its displacement from SYSREE in the rnacro expansion. 


Notes: 
a. In all programs in which the CMSYSREF macro is called, SYSREF must 
be declared in an EXTRN statement. 
Example: 


The following exumple shows how to call the SETCLK function: 


SAMPROG  CSECT 
EX'TRN SYSREF 
L 5, = A (SYSREF) 
L 45, DSETCLK (3) 
BALR 14, 45 
LTR 45, 15 
BNZ ERRET 


CMSYSREF 


01-22-68 
3.4, 4..2-20 
CMSYSREF 252 


In the expansion of CMSYSREF, DSETCLKE is equated to the displacement of the 

SETCLK routine in the SYSREF list. The address is loaded into register 15 for 
the BALR, and register 15 is checked for an error code after control returns to 

SAMPROG, (ETCLK is a routine which saves the current value of the timer for 
subsequent use, as described in the CMS Program Logic Manual. ) 


Le 
~~ 
Cc 
£ 
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3.4.1,3-1 
7, Jo Gh: 
- PEGE Note that. cnly the ferns c& the above racrcs which are used Ly eee 
3.4.1.3 CS Eacros wed the CS language processors are supported under CHS. Prograngs ‘’%~- 
: which use OS macros not listed ahave or use unsupported foras of 
the above macros will nat cun Correctly uncer CHS. 


wc 
= 


The OS pacrcs that are used by the Canbridge HNonitor Systen are 

contained in the file SYSLIE NACLIB SY, which resides cn the p : ; 

systen disk and is called the systen macro library. The CHS The follcwing 0S macres are defined in CHS but they do not 

acres are also contained in the library. Fer a discussion of perforr a function as in G5. They are essentially a no-ap; they 

the CHS nacres, refer tc Section 3.4.1026 have no gseaning in CHS and they return an error code when the SVC 
‘is issued. ; 


Ic cbhtain a list of the nazes, size, ard leccaticn cf the nacre 

Gefiniticns in SYSLIE MACLIB, the connand "HACLIB LIST SYSLIB" ATTACH 

may te issued. To print cut. the macre definitions, refer tc CHKET 

Secticn 3.14.10. ; ; _ DETACH 
LEQ 
DILEDVE 


The CS sacrcs uhich are supported under CNS are as follovs: ea 


‘ IDENTIFY . 
AEEREL F . STINER 
BLDL 
BSE , , 
CEECK ; For a discussion of the CS nacres thenséives, refer tc IBN manual 
CLOSE C28-6647, “Operation Systen Supervises end DBeta Wanagenent 
. pes Hacro-Instructions. Fox @ Cescriptica c&£ the use’ of the CS 
CCRE racres in CMS, refer tc the "CES Prograr Logic Haénual". 
LELETE , 
DEVIYPE 
FIND 
FREEXALS : . 
FREEPOOL 
GET 
GETHAIN 
GETECCL 
LINK 
LCAL 
NCTE 
GEE 
POINT 
FCST 
EuUT 
FUTX 
RI-GECB 
ato a REAL 
we RETOEBN 
‘ SAVE 
SFIE 
TINE . 
WAIT . . 8 : 
WAITS 
WRITE 
¥10 . . 
( WIOk , : 
XCTL 





—— 





05/01/65 ; Ud/s/ULsboY 
; , i Sou. L NR? 
SAS “ERS Naleus Reukines Sot hed read cr write a tape record. The use of the functions as /,i5% 
LEC} a conmands is described under the section on CMS ccoumands. Ps 
ie 3S 6 ee / 


Routines which are contained in the CNS nucleus and can be called 
with the SY¥C X'CA' are called functions. These routines serve as 
the hasic interface between proqrars and the CUS nucleus. 3 

, ; The FLIST for the following functions are described belovw: 


fhe callirg sequenca fer all routines are of similar format. 


There are twa parts of each calling sequence; the cede to .. ATTN ‘Stack a line for terminal input 
transfer ccntrel tc the CNS routine, and the parameter list. The CARTEE Punch cards : 
inline ccde always has the folloving forn: CARERE Read cards 
; : CCNWAIT Wait for terminal I/O to finish 
LA 1,ELIST put address of parameter list inte GPRi CPFUNCTRN Issues CP-67 ccnsole functions from CHS 
SYC X*CA?! transfer centrel te subroutine . DES EUF Clear terminal input stack 
he ALY (ERR) address of error return if desired ERASE Erase file(s) 
ak nernal return FINLIS Close file(s) 
. : ANDINT Set or clear I/O Interrupt Return Addresses 
. HRDSVC  ° “Set or clear SVC handling addresses 
; oo. LOGLISK Update £ile directory 
Register 15 is the only register that is modified when control is PCIKT Set Read cr Write pointer 
returned tc the calling ;reqrar. - Upon a norual return, register - : PRINTH | Print line 
15 will centain zero. Upon an errox return, register 15 will ; REBUE Read item(s) from disk 
coutain an integer error cede. The exrrere codes are described in STATE Query file status 
the write-up of each routine. If an errer return is specified, : VAPEIC Tape IyO handling 
_ the byte after the SVC instruction will be zero and the following TRAP Set external interrupt address 
three tytes vill be assumed te centain the address of the error TYPE Write te terminal without carriage return 
leturne If the error return address is specified, the norral TYPLIS Weite to terminal with carriage return 
return will be te four bytes after the SVC instruction: , WALT. Wait fox interrupt 
otherwise, it vill be to the location after the SVC instructica. , WALTHE Read terminal 
If no errer bandling is to be peevyided, it is reconmended that be WRBUF Write item(s) on disk 


ALG (¥ 4+) ke used, otherwise an error will cause DEBUG to he 
entered. 


The ELIST differs for each routine and is descrihed in subseqnent 2 
sections fcr, each reutine. All functions can be called directly 

as ChS ceomrands although many functions require a perareter list . 
specified in hexadecina and thus shculd cnly be called from an 

assembly language proyram.e The folloving CNS conmands directly 

call the equivalent CMS functions and are described under the 

sections on CHS commands: 


ALTER, CLCOSIC, ERASE, FINIS, GFNMOLT, GLOBAL, LOAD, LOALNOD, , 
REUSE, USE, STAIT, $&, LTEBUG, EXFC, LOGOUT, IPL, BLIP, " is 
LINENE.! : 7 


The commands ALTER, ERASE, BLIP, and LINEND should be called fron 
an assembly language program as functions if it is desizahble te 
specify a character which cannct bo typed from a keyboard. 


The functicns STATE and TAPEYO are useful as commands as well as “ ras 
functions. When called ‘as a function, STATR veturns the address 
cr a cepy cf£ the Elle status table which can be. used in further 
processing. When called ag a function, TAFEIO can be used to 
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05/01/69 Pore 
i t - Doan 
m (wee sata + blue 1.4.2 CARIPE C25 7 
3.d.70801 ATTh fis 
ws Burpese: 
JIECEC! ; Pore _s 
ce The CARDPE functicn punches a card fro the specified 80 byte 
The ATIN function stacks a line into the input buffer. aceae 
Calling Sequence: Calling Sequence: 
PLIST rs OL 
tc CLE'ATIN® PLIST [Ss op cue ae 
rc CL4torder! LIFO or FIFO rc C18 CARDEN! Fe ae 
[Cc AL1(LBUFF) Ic A (buffer) 80 byte a 
rc AL3 (EUFE) 
EUEF rc C'linet reer Codes: 
LiUFE ECU * =— BUFF — . 
£(0CCC1) End cf file 
: ; E (Q0002) Unit Check 
bsaus: . F (0000 3) Unknown errer 
E (00004) Not operational 


The line that is stacked will be unstacked and used when a call 
te WAITRE dis made te read a line fren the typerriter cousole. 
aty nucver of lines may be stacked for subsequent use instead of 
terminal irput. hen the input stack is empty, the keyboard will 
be unlecked to receive typewriter input. 








- 05/01/69 . . es 05/01/69 
. B.H.1,4,3-1 . 3.4.12.4.4-2 
304-104.3 CARERD . | FEF 36451.4.4 COKKALT : wee he “ie | 
Eurkgsot | | - EEE | ee : - ae 
The CARDKE function reads a card into the 80 byte area specified. The CONWAIT function waits for all stackei reads and writes to 
2 "finish" from the console. typewriter, 
Calling Sequence? 
Salling Sequence: 
ELIS1 15 OD . : . 
Lc CLE*CARERI! routine _ ELIST [Ss oD 
PEG A (buffer) 80 byte area a | EC . CLO'CONWAIT! 
3 Tc CLY'CCNI 
Epror Codes: 
io, we Beige: 
§ (00001) End of file 
E(00C02) —  , Unit check a CONWAIT is called as a standard CHS function... The device. id 
E (00003) Unknown error ; ; ‘CONT corresponds to the console typewriter. 


£(00004) Not operaticnal 


32407.04.5 CPFUNCTN 
Furcec3e: 
Jhe CEPUNCTN £unction transmits console functicns to 


without leaving the virtual machine mode. 


SS Ss de SS 


CS OF 

DC CLEICEFUNCTK® 

BPC CL8°*NO NSG' This parameter may be omitted 
pC Cln'CE command string! , 


DC X'FEFFFFFF® fence 


E(00C91) Ke CP cconand string fresent 
E(COOO4) ° INVALID CE REQUEST 

£(CCC08) EAL ARGUMENT 

€(xxxxxX) Any other error ccdes are fron the 


CP console function specified. 


. 


» 
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3.4.1.4.5-1 05/01/69 
AD 3.4.1.6 CESBUF aha i 
ie ae 
F363 
Eurpose: 
The DESBUF function clears the input buffer cf stacked lines. 
ess Calling Sequence 
FLIST ts oD 
cc CL8'TESEUF!? 
Usage: 


When DESBUE is called, ali input ‘lines 


Freviously stacked are 
deleted, leaving an empty input buffer. 


“_ 














3.421704.7 ERASE 


Ef Fes: 


The ERASE function erases the specified file(s). 


Calling Sequence: 


" EL15T 


ELEcE Codes: 


£(0CCO1) 
F (00002) 
E (C0004) 


Ic 
Ic 
tc 
{Cc 


. CI8'FINIS# called rcutine 

CL8! ‘ filenare or * 
CcLé! ’ filetyfe or * 
CL2' ‘ mode or * 


First character of mode illegal 
File not found 
Disk error 


05/01/69 
3.4.1.4, 


“A, 
HEE 


ef 


3e4e1.40U FINS 


ruEpgSC: 


fhe FEINIS function 


Note: 


Errer_Codes: 


E (0000 1) 
F (00002) 
£(0CC03) 
E (00004) 
E(0000n) 


rc 


closes the specified file(s). 


CLO'FINIS® 
cLaét 8 
ce! ‘ 
cLa¢ ¢ 


‘invalid filenane 
invalid filetype 
disk errcer 
invalid mode 
file net cpen 


called rceutine 
filename or * 
filetype or * 
mode letter or * 


FINJS does not cause the directory to be updated on 


ty 
: 


the disk. 


tad 
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Op AL, - 
GRA 


S65 ° 
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“ieee 


TEL 


3.4.7.04.9 HADINT 


The ENLINT function sets the CNS I/O interrupt handling routines 
tc transfer control to a given location for an I/0 device other 


than those normally handled by CMS, or to clear. such transfer 
requestSe. 


cs : OF : 
ELIST EC CLO'HNDINT! . called routine 
[Cc CLO'SET! or CU4tCLR? function 
IODEV NANE,NUMBER,ADDRESS, 
ASAP/WAIT-FLAG, KEEP/CLEAR FLAG 
tc X°FEEFPEFF¢ end cf list 


Eiror_ Codes: 
E(00C01) Incorrect parameter list 
facro ICDEV: 


The IGDEV macro sets up the following information in a 12-byte 


field: 
NAME = Symbolic device name (ist 4& letters) 
NUUHEE = Hexadecimal device address 


ACDREES = Symtclic address cf interrupt-handler to be 
invoked. If address = 0, interrupts will he 
igncred when received. 

ASAF/WKIT-FLAG?: 

ASAP = Inveke interrupt-handler immediately. 
WAIT = Invoke intercupt-handler cnly when 
‘WAIT’ is called. 

KEGE/CLEAB-FLAG: : 

KEEP = Retain interrupt-handling between CNS commands. 
CLEAR = Clear interrupt-handling after each 
CHS command. "CLEAR‘t=DEFAULT OPTION 


Examcle: IODEV NEWD,38°7,NYCODE,ASAP,KEFE 
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3.4.1,4,9-2 


eae 


COU 
dhen an interrupt is received and preceesed hy ‘IOINT*, it passes $b; : 
control tc the interrupt-handler as follcws: 46/7 : 


Register C,1 I/7c OLD PSW 
2,3 CSW 
4 Device address 
V4 Retucn address to ICGINT 


15 Address of interrupt-handler 


when processing is complete, the interrupt-handler must return to 
IOINT via register 14, with Register 15 as fellows: 


RIS = 0 means 'SUCCFSSEUL HANDLING? 
R15 Nenzero means "ANOTHER INTERRUPT EXPECTED'. 


Tne genera] precedures fer CMS I/O handling:using ‘HNDINT' are as 
follows: . 


1. dhe pregram must initialize handling tc ke done via "HNDINT SET‘. 


2. then IyC to the appropriate device is to be done, the system-mask 
must te set 'OFF* {ry 'SSM* instructicn) and appropriate ‘SIO’ 
given. 


3. when ‘SIC! is performed satisfactorily, the system-rask can be 
eet tc alicw all interrurfts. : 


Wa, If 'tASAP' waS Specified, the interrupt-handler is invoked as soon 
as the interrupt is 'fielded* Ly CMS 'IOINT'. The 
intercept-handler returns te ‘'IOINT’ hich returns to user's progran. 


ab, If *ASAF* was net specitied, 'IOINT' retains needed inforration 
until CMS 'WAIT* functicn is called. 


©, when program ‘needs! the interrupt tc have heen received, CMS 
‘WALL! function is called. If interrupt has not yet been 
received, CMS aces in tWAIT! state until. 'LOINT' fields 
and precesses tke interrupt in normal waye 


If the interrupt has. been received and processed (e.g. on ‘ASAP'), 
thAIT! returns te caller with necessary internal flags cleared. 


If the interrupt has been received Eut not yet precessed (as 
under "WAIT ofticn instead cf 'ASAP'), CUS "WAIT! 

now calls IOINT to invoke desired interrupt-handler, then. 
clears necded flags and returns to caller. 


6. when finished, using preqram shculd ncrmally clear the 
interrept-handling scheme thru fHNDINT CLR call 
(unless 'KEEE* option is used and the interrupt-handler 
remains intact in cere). : 


RR EE Om 


Seg 7ee e 05/01/69 

SoH. 24 ; 

a B.4.1.4.10-2 

3°".1.4.16  HDESVC 2e LED 
he Z. %Indiviéual SVC-nuakers may be added or cleared pees 

at different times but should all ke cleared FE . 
EVEESES! tetore terninaticn cf the command. 
The HNDSVC functicn initializes the SVC=Interrupt Handler to frror Codes 


transfer ccntrol to a given location fcr a specific SVC number 
(other thar X*CA* o£ 202), cr to clear such previous handling. 
& (00001) Incorrect PLIST 
EF (00002) SvC-number replaces another of the same nugber 


Calling Sequence: | , & (00003) SVC-number clearing cne which wasn't set 
DS OF 
PLIS4 pc CLO'ENDSVC! called routine 
cc CLA'SET® or CLO'CLR' | function 
pe ALVT(SVC-numnber),AL3¢address argurent) 
mC XS EBEFEFFF' end of list 
I ge: 


At entry to a non-Chs SVC-handling routine the following 
conoitions exist: . . : ; * 


Registers — ‘ 
C-11 and 1£ as they ware at SVC time : 
12 address of SVC~handler routine 7 
13 address cf SVC save area 


14 return address to SVCIRT 


The SVC save area has the following format: 


Bytes ) .  _ Contents 

0-63 ; Callerts registers 0-15 

64-71 SVC-old-PSHh 

72-65 Floating-Foint registers 2,4,6* 
96-176 80 kytes for use by SVC-iandler 


*PER 0 ds saved hy CMS elsecwhere. 


1. For CLE, the address fields are irrelevant. 
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3.H.2.4.2)9  3.4.164.22 POINT : LES ; 
3.4.1.4. 21 icEprsR Lit IY/ 
“> 
776 "rEcse: | 


Eurpose: 
The peint function sets the read pointer andyvor the write - 


ointer at a specified item number. 
The LCGEISK function closes all crfen files and writes the r 


file directcry onto the disk. 


€alling_ Sequence: 


ELIST cc CL8°FCINT! called rcutine 
CC CLBt ‘ filenane 
FLIST DS cr DC cLé! . filetyre 
cS CL8'LOGDISK® . rc C12? ' fade. oe 
rc He¢ ' woite pointer 
DC Ht ‘ “read pointer 
Qsage: . ‘ 
; , ; Meta: 
Ihe user schould call LCGDISK during the execution cf his program 
if he wants tc cause new cr medified files to be permanently 
written onto the disk before the completion of the preqram and This routine sets the read cr write pointer in the file status 
the return te the CNS command envircnnent, table to a value provided by the caller. Zero leaves the pointer 


unchanged; a value cf all bits sets it to the last item number 
{ plus one. : 


Error Returns: 


Nene. 
If the directory cannot bewritten out, the virtual machine is put i ; 
in disabled wait state and control will ke passed to CP. £ (00001) File specified dees net exist 

! 


B(cccd2) First character mode illegal 
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ay 
oo ee Ser ete tetas 
B72 ; 379 
a¥E ESS: EULEORR! ; 
fhe FRLKTE function outputs lines on a printer. The NDBUF function reads an item of information from a disk file. 
Calling Sequences , Calling Sequence: 
tc CLO'PRINTR® DC A (buffer) buffer area _ PLIST {C C1LB‘RDBUF® called routine 
DC *  A(bufsi2) tuffer size Ic CLe' §* filenaze 
cc cLee ft filetype 
Ps EC Ctra" ¢. rede may be & 
Netes: tc item nurber 
[Cc  A(userarea) pointer te input buffer 
IC FS ' number of tytes in buffer 
1. The first byte cf the buffer is used for carriage control TC 8 6CL2¢F fixed-variable flag (F or V) 
and ig not printed. The carriage controls are? tc 86H#f : number of items to read 
. Ic F ' number of bytes actually read 
cLif & single space 
CLi*ct dcuble space 
clit page eject Ecres Codes: 
2. Machine CCH OF code carriage controls (as used by the 
é assembler) are alsc accerted, E (0000 1) File type does not exist 
, F (00002) User's remcery addrees is not in iis user area 
3, The buffer size should not exceed 133 bytes. I£ buffer size E (0603) Disk malfunction has cecurred 
js 1, cnly the carriage contro) will occur. # (00004) First character of mode illegal 
: . £ (00005) Number of items equal zerc 
6 (00007) Pile not written with WRBUF therefore it 
freor Codes: cannot te read 
E (00008) User's memory area too sma}l for item 
F( 00010) Eight files already cren 
£ (C0001) Printer unit check £ (00011) Nunber of items greater than 1 for variable~ 
2(C0CO2) Illegal carriage control length file 
‘E (00003) Inccrrect parameter list E (00012) Item number specified does not exist (EOF) 
£(C0004) Not operaticnal £ (00013) Characteristic net ccrrect 
B (00005) Unknown printer error : 
Rots: 


_t ALL] errors except errot @ cause the function call to be 
atocteé. On errcr cede 8 that fortion of the item that 
will fit in core is read. 

2. The nunter of tytes-in the user area divided by the 
nupber of items must be constant (i.e., the sane legical | 
record length) fcr a fixed-length- ROCOE? file. 


‘ 


‘ ; 
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3.8.2.4.176-) 
HOTU L 15 ~ : 
. $.8.2-4,25-1 3.4.1.4,16 TAPEIC ie Lig 
3.4.1.4.15 STATE : LYE ee 
, SY . fe 
“F £urrcse: 


EUrEs 


s£?, 


1? 


a The TAPEIO functicn reads cr writes a tape record, or 
The STATE functicn prevides a cory of the FST (file status table) ; positions a tape. 


entry for the file specified in the parameter list. 


: Salling Sequence: 
Calliny Sequence: 
| ELIST cs OD 
ELIST EC CLEtSTATE! called routine : rc CL8'TAPEIO! 
tc CL8! : filename ; EC CLE'functicn? 
rc CLBt. ‘ filetype ; Ic CL4'deviceid' Symbolic tape address 
rc cL2' 3 mcde letter or * a Ic: XL1'mcdesett 7-track ncde set 
rc cCL2" # unused ' IC: “AL3 (buffer) Ruffer address 
ERETN Ic A(*) address of FST copy [C- F'sizet Buffer size 
returned y CCUNT LS F Number cf bytes read 
Actes: ; ; Functions are: 
1, PHRETN will ke set to the lccaticn cf a copy . ESE to kackspace one file 
cf the file status table entry desired if . : , BSR te hacksepace cone reccrd 
the file is fcund. © . « FSF to forward space one file 
: FSR to fcrward space cne recerd 
z. Mode of * means that the first file found REAL £0: oad one record = 
with name and type specified will be used. REWIND tc rewind the tape te load point 
The crder cf search is fermanent, tempcrary, : FUN to rewind and unload the tape — 
and system files. WRITE to write cre record 
‘e ; KRITEOF to write a tape mark 
- hIN to write a tape mark 
Error, Codes: oar ERG. to erase a qap 
£(00001) File specified dcesntt exist Device 1£s are: 


E(COCC4) First character cf mode illegal 


TAF1 or TAF2 corresponding to 180 or 181 


The modeset code is cne Lyte of the form: 


’ ae . CCDMMMO11 with the fcollcwing interpretaticn 
DD. track density 
‘ i 200 
: 01 < 556 - 
10 i 800 
11 j 600 








: 05/01/69 a SE 05/01/69 
° . B.4.1.4.16-2 3.4,1.4.16-3 
uM Wig ie od. eee oe ache ht aoe ne yR ea i Pa - £47 
000 } not used nt Lite : ae 37 
001 j nat used FG F (00002) a 
010 Jf set density, cdd parity, ccnverter on, translator off © An end-of-file or end-of-tape has ecccurred. 
011 ! not used ; . 
100 j €ven parity, cenverter off, translator off 
101 | set density, even parity, ccnverter off, translator on ~ £ (00003) ; 
110 | set density, odd parity, converter off, translator off A permanent I/G error has occurred while reading or writing. 
111 | set density, cdd parity, ccnverter of£, translator on ( ‘ 
: ; ' £(00004) ot An 
Us3ge€: An illegal symbolic device id was specified. 
the functicn TAPEIOQ can ke used to read, write or move magnetic E (00005) TAEn NOT ATTACHEL 
tape. If the WRITE function is used, the number of. bytes The tape unit has not been attached to the virtual machine. 
indicated will be written. If the READ function is ‘used, Refer to Section (5.5.0 Tape PECCeNUEYS» 
informaticr will be moved into the buffer and the number of bytes ~ 
read will be stored into CGUNT. If a tape mark is read, the : 
functicn will] return with an error code cf 2. ' EB (00006) TAPEn IS FILE PROTECT EL ‘ 


The tape contains a pee TE eOrS® ring, therefore the tape 


can not ke written upon, 
Ketess 


F(00C07) TAPn - SERIOUVE TAPE BBROR APTEMETENG function 


1. A wode set of X¥'0C' causes the default mode bit of K'p3! An unrecoverakle tape error has cccurred while atteppting 
to ke used. 2 ’ the epeottive function. y, 
2. =A nope set of X'E3" indicates density 80C, parity odd, 7 rs 
converter off, and translater cff. ; : 
3. A mode of X'93! indicates density 800, parity odd, converter on, 
and translator off. 
fes3ages: ” 
TAPn ‘NOT REALY YET 
The tape has been attached but it is not ina ready 
Barnes Phe 
(OK - REALY NCR) x 


The tape is now in a ready status for use. ie a 


Errcr Codes: 


E (0000 1) INVALID "TAPEIO READ* PARANETER-LIST 
An invalid ‘Parameter list was specified for reading tape. 


£(00Q001) | INVALID 'TAPEIO WRITE! PARAMETER-LIST d 
: An invalid parameter list was specified fer writing tape. 


5 





3.4.1.4.97 TRAE 
Furecsez: 


The TRAP function sets a user's return fer an external 
This return overrides the call to DEBUG cn an external 


ee 


PLIST DS Or 
pc CL8* TRAP 
DC A (trapsubr) 


05/01/69 


3.4.1.%.17-2 
My 


GSS 


interrupt. 
interrupt. 


where "trapsubrc" will be the location transferred to on an external 
interrupt. If the parameter “trapsubr" is a zero, the return will be 


reset to gc to CEBUG cn an external interrupt. 


Usage: 


‘The user's interrupt routine should set a flag which shculd be 
examined Ly the main line program. After the flag is set, 
this routine should return to the location specified in GPR14 
on entry. All cther general registers can be used as desired. The 
main line program should periodically examine the trap flaq te 


determine whether an external] interrurt has occurred. 


 Egror Returns: 


x 


Ncne. 


304,704. 18 TYPE 


Purpose: 


lhe TYPE function types an output message cn the console. 
blanks (if any) 


PLIST 


NSG 
EWSG 


where the 


ot me ew 


E (00001) 
E (00002) 


cs 
tc 
cc 
rc 
tc 
[Cc 


° 


cc 
FQU 


05/01/69 
3.4.2.4.18-2 


SYA 
fr Lp 


274 


Terminal 


are nct deleted, and no carriage return is added. 


. 


OF 

CLEO'TYER 
AL1(1) 

AL? (MSG) 
C'ccde! 
AL3(ENSG-BSG) 


* 


write codes are: 


E = move line to free storage before typing. 
K = type line frcm the specified lccation. 


Invalid terminal nunber 


terninal number 

address of output nessage 
ccde .B or K 
message length (in bytes) 


(see below) 


C' message tc be typed withcut carriage return'* 


Length cf cutput message not between 1 and 130 bytes 








: | ; 05/01/69 : ee 


: 7 7 05/01/69 
“ . 4 9.4.2.4.19-1 . : : i 4 . B.4.1.4.20-3 
FIC i ; ‘ Li 
Eurpcse: - 7 : Furpage: — : , 


: } 
' : ‘ i ‘ r 


The TYPLIN function types an output line on the console. ‘Terwinal 


fhe WAIT func 
blanks (if any) are deleted, and an automatic carriage Otay is unc ELON ANAS ER AN: AR ESEEUDE Frow- Ona of rhe 


specified devices. : 
added. ; | P ices ; ae 
calling Sequence: 
Calling Sequence: : wh ddo1g259¥S 068 : 
3 | . ps OF | | ; 
cs OF : ; PLIS c a t : 
PLIST IC CLE*TYPLING : a ie Laas u ea ; 
tc AL1(1) terminal nunsber ; ; : 
[Ic ALJ (SG) address of cutput message . : 
tc C'codet code B or K (see below) © ' : ; 
fc: .AIL3(ENSG-HSG) message length in bytes Ic | FQ! : ‘ 
_ " INTDEV rs F iy & 
HSG oC Ctactual message to be typed with 7 where the device ids are: CON1, DSK1, PCI, RDR41, 
carriage return added! : ; PRN1. TAP1, and TAP2 
ENSG ECU * | ; Shem 
; : Esaje3 
where the srite codes are: D ’ 
: : When one of the | specified devices causes an interrupt, the device 
BR = nove line to free storage Ltefore typing. a b a 
K = type line frem the specified lacation. | id will ke store in the used INTDEV and control will return to 


the calling pfrogran, 


‘Error Returns: 


1. Output linc must be 1 through 130 bytes in length E(00001 T li devi ws 
{unless byte count is 0, which forces typing a single | Baas Oe agoney eneen tier. 
carriage return). 

2. No differentiaticn is made between red-and~black-ink 

‘ typeauts. 
Frror_Code: : 


E (00001) Invalid terminal number 





: 05/01/69 3 05/01/69 


3,6 .2.4.21-1 | 8.4 51.4.21-2 
3e40104.21  KAITRE en ) Lt 
; ead Erroc Codes: ae 
92; 383 


ftrpose:: 2 

EB (00601) Invalid terminal number 
“2 E (00002) *Rpead-tyre! invalid (not U, V, 5, T, or X) 

The WAITRE function reads an input message up to 130 bytes in , 

length into a given. buffer from a console and waits for 

completicn of the input message. 


Calling Sequence: 


ts OF 
PLIST tc CLE*WAITRD* : 
Ic “AL1(1) terminal number 
rc AL3 (INPBUF) address of 130-byte a 
; input luffer ; 
rc C 'codet U, Ve Sy Ty, or X 
(sce belcw) 
“re AL3 (*-*) byte count of input 
mesSage is stored 
here 
INPBUF cS 130C 130 byte {or more) 


input ruffer 
An input line can he edited as fcllows: 
Use the tat signt @ to delete the previous character, 
or the tcent sign' ¢ to delete an entire line up to and 
including the cent sign. 


Conventions for U, V, S, T, cL X ares 


v 


*Ut performs editing, upper-case translation and blank filling 

‘v' performs editing and upfer case translation 

*S' performs editing and blank filling (there is no upper case 
trarsilaticn) 

'T' performs editing only 

tx! leaves input line exactly as is 


Not 


lo 
lin 


; 1. If the user has 'stacked' input commands, WAITRD will 
: . accept the first 'stacked' input message, and move it 
-to the specified buffer. . 


2. ‘The ingfut buffer is zerc~filled before read is 
initialized, and must be at least 130 bytes long. 











- 05/01/69 
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- ve / I 
3.4.1.8.22 WREUE . . MAG 
B&F 
‘Prrpose: 


The RRBUF function writes cne item of infcrmation into the file 
whose name is specified by the filename and filetype parameters. 
If the file does not exist when this function is first called, a 
new file sill be opened and assigned the given name and type, 
HRBUF will autcmatically pack fixed length itens in an 6000 Lyte 
buffer, and write this 800 byte Elock onto the disk, 


ELISI [c CLO 'WRBUE! ‘ 

“EC CL8! ' filenane 

rc cL8? 4 filetype 

rc CL2$ ' . nede must be specified 

not * 

Ic Ht item nupber 

rc At ) user's kuffer address 

tc F! ’ number of hytes 

cc ci2' ‘ fixed-variable flag, F or V 
tc H? ‘ number of items to write 

Errcr_Ccdes: 


E (0000 1) File name not specified 
E (00002) User menory address nct in user area 
£(00C03) - Lisk nalfuncticn ; 
_E£(00004) First character mode illegal 
E(00005) Secend character nade illegal 
£ (00006) Core space not available 
£(C0CQ7) “Attempt to skip cver unwritten variable length iten 
E (60008) Number of bytes not specified 
F(00009) File already active fer reading 
£ (00010) Fight files already open 
FE (00011) F-V flag not F cr V 
E (00012) Kode SY (systen) is illegal 
§(00013) Disk already full 
E(0001%). Attempt to write on read-only file 
E (C0015) Length cf this item not same as previous 
E (00016) Characteristic (I-V Flag) not same as previcus 
F(00017) Variable length ites greater than 65K bytes 
£E(00016) Number of items qreater than 1 for variable length file 
E (00019) Nupber cf iters equal zero 


Acta: 


The nurber of Lytes in the user area divided by the number of itens 
Bust be constant (i.G., the sane logical record length) 
for a fFixed-leugth~-cecord file. 
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FORTRAN SSS | rorrran 346 
3.4.2 FORTRAN | Usage: 
The FORTRAN command compiles files of FORTRAN source language 
Pucnesei ‘ into machine~language object code. Input files must have a filetype 
cs de of FORTRAN and a record length of 80 characters. Up to 32 files 
The FORTRAN command compiles progxams written in FORTRAN Iv into may be compiled by one command by listing the filenames, and 
machine code, and prevides program listings and diagnostics. each file may contain anv number of routines, each delimited by 
; an END statement, Each file procensed will generate ona object 
Format: , j deck and one listing, replacing any previous output files for 
Se ae : the Same program, 
{FFORTRANy! fl leah inn Pca OREN [(option1.. optionN) The options governing compiler operation and output are specified 
ews ee Ss Lecnwclndcn anton anininhnnnwaka nanan ane remeuoeesecal in any order in a set of parentheses following the last filename, 
; a One set of options governs all compilations performed by one 
filename is the name of a FORTRAN file to be compiled, command, Kach of the eight options has a ¢efault value which is 
Up to 32 separate compilations may be belected when none is specified. The default values are: 
performed by adding filenamos, separated : 7 ee eae 
by blanks. NOGO DIAG EBCDIC DECK SOURCE NOMAP NOLIST NOPRINT 
option is one or more of the cight compiler q Any combination of options is valid, but the result of specifying 
options. more than one value for a single option is unpredictable, 
Unsupported or misspelled options are iqnored. If no options 
R sts 
Options: ; are specified, the parentheses are not necessary. No filenames, 
= , 3 options, or conmants should be placed following the closing 
MAP includes tables of FORTRAN variables, parenthesis, | 
NAMELIS’£, and FORMAT statements in the ; : ; ; 
LISTING file. Diagnostic and error messages produced by the compiler ave placed 
NOMAP |" suppresses: the tables of variables. in the LISTING file (see Output), and, unless the NODIAG option 
Set is specified, typed out at the terminal, The compiler error 
DECK generates the TEXT file of object code. messages have two formats, depending on when the error is detected 
NODECK ‘ suppresses the TEXT file. (see Figure 3.4.2-3). Statements in which an-error is detected 
during the statement scan, such aS a Syntex error, are typed 
LIST “. includes a listing of object code in assembler out immediately, followed by a line with a "$" beneath each 
language mnemonics in the LISTING file. point at which an error was detected. The "pointer" line is 
NoLtIsr | ©. suppresses the object code listing. followed by the error: codes and explanations, numbered from 
cates left to right. Tf an error, such as an undefined label, is 
SOURCE includes the source program in the LISTING file. not detected until statement scanning is completed, the error 
NOSOURCE suppresses the listing of the source program, message is typed, followed by a list of the labels or variables 
in error, . 
BCD is used if the source program is punched in: : 
Binary Coded Decimal. If source statement errors are detected, CMS terminates the 
EBCDIC | : is used if the source program is punched in compilation with a message and an error code of 32. If the GO 
Sees es Extended Binary Coded Decimal Interchange Code. option is specified, CMS does not terminate processing, although 
; for some conditions the compiler terminates itself. When processing 
forces compiler processing to completion despite is completed under the’ GO option, any error completion code is 
source statement errors. the greatest error severity code assigned by the compiler (see 
NOGO terminates compiler processing when serious Error Messages). 
errors are detected. : : P , 
; Source files read through the offline card reader for compilation 
PRINT prints the LISTING file on the offline printer, may be punched in either Binary Coded Decimal (BCD) ‘or Extended 
and deletes it. ; Binary Coded Decimal Interchange Code (EBCDIC). If BCD is used, 
NOPRING suppresses printing of the LISTING file, the BC) option must be specified. 
DIAG types source program errors at the terminal, 
NODIAG suppresses typing of source program errors, 


. 


07-24~6 
3.4.2-3 ue 
FORTRAN 70/ 


Output: 


Files with the designation “filename TEXT P5" and "filename 
LISTING P5," where "filename" is the name of the FORTRAN 
input file, are produced for each file compiled. If NODECK 
is specified, the TEXT file is suppressed. 


The object program in the TEXT file is identical to that produced 
by a compiler under the Operating System, and object decks may 
be loaded and executed under.CMS of OS. The entry point for 
the first main program in the file is the same as the filcname. 
Subsequent main programs in the same file all have the entry | 
point NAIN. Subroutines have the entry point specified in the 
SUBROUTINE statement, regardless of their position in the file. 

4 


Under the default options (SOURCE NOMAP NOLIST) the LISTING 
file contains the source program statements, diagnostic 
messages, and a,statement of object program size in bytes (see 
Figure 3.4,2-D). I£ NOSOURCE is specified, the source program 
‘ statements are suppressed. However, statements in which errors 
_-were detected are always included, with error messages in the 
Sane format as they are typed at the terminal. 
If MAP is specified, a table of addresses is gencrated for each 
. of seven classifications of variables used in the source program. 
The classifications are COMMON, EQUIVALENCE, NAMELIST, FORMAT, 
“scalar, and array variables, and called subprogram names. 


If LIST is specified, a listing of the object program is 
generated, with relative addresses, and instructions translated intc 
assembler language. 


The PRINT option causes the LISTING file to be printed on the 
offline printer, and then deleted, Tf NOPRINT, the default 
option, is specified, the LISTING file is saved on the permanent 
diek, and may be printed with the OFFLINE PRINTCC conunand or 
typed out at the terminal with the PRINTF command. 


ay Previous LISTING and TEXT files with the same filename 
as the current FORTRAN input file are deleted, although in some 
cases they may not be replaced because of different options 

or an error termination. 


b, If multiple files or a file with multiple routines is- 
being compiled, the GO option should be specified to prevent an 
error termination of one compilation deleting all compilations 
requested. : 





9 a | 07-24-67 
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rortRAN 3YS 


<crencess 


The FORTRAN command executes the System/360 Operating Systein 
FORPRAN IV (G) compiler. Fox information on the FOR’RAN IV 
language, see IBM System/360: FORTRAN IV Language Porm C28-6515, 
anc FORTRAN JV Library Subprograns, Form C28~-6596, For 
information on compiler operation and messages, see FORTRAN IV 4c) 
Programmer's Guide, Form C28-6639. Information in the Programmer's 
Guide on Operating System job control language and data | 
management is not applicable under CMS. The LOAD, NANE=, and 


LINECNT= options are not supported, 


Responses + 


Source statement errors and compiler messages are typed at the 
terminal unless NODIAG-was specified. If GO was specified, 

or if no errors were detected, there is no response except the. 
Ready messayc or an error completcon code. The following responses 
should not occur: 


READY THE PRINTER, 


I/O BRROR ON PRINTER. *' PRINT! OPTION CANCELLED. 
A 'LISTING' DISK FILE WILL BY CREATED. 


‘f either appears at the terminal, notify the responsible 
system programmer. 


Exempies i 


a. see Figure 3.4.2-A ; ee 
A file, FAC FORTRAN P5, is to be compiled. No options are specified, 
so the set of default options governs the coinpilation. At statement 
001], the compiler detects two errors, at the points indicated by 

the $ in the succeeding line. Error 01) refers to the left S$, 

error 02) to the $ at: the end of the line. Explanations of the 
error codes are found in the FORTRAN Proyraweer's Guide. CHS 

cancels the compilation and supplies the crror code £(00032). 





b. see Figure 3.4.2-8 i % 
The same file as in (a) is to be compiled, but the GO option 15 
specified, The same errors in statement il are detected, but 
processing continues. Another erxor, an undefined label (40), 
is found before processing is completed. The completion code, 
E(00004), is the error severity code assigned by the compiler. 


. 
. 


c. see Fiygure 3.4.2-C i 

Shree files are to be compiled: FAC FORTRAN P5, SUBL FORTRAN P5, 
and SUB2 FORTRAN PS. No errors are detected during any of the 
compilations. Maps of vaciables are included in each of the three 
SISTING files, which are automatically printed offline, and 

erased from the disk. 


d. see Figure 3.4.2-D 
An example of a LISTING file generated: under the SOURCE MAP 


NOLISST options. ee 























Pigure 3.4.2-D 


(J 


fortran-fac ‘ : 
ooil 1F(J) 300 260 ino 
$ : 
oh £92.95 fFLLESAL LABEL 02) ERR 15 SYNTAX 
COMPILATION CANCELLED DUE TO SGURCE PROGRAM ERRGRCS). ; 
E¢OSC352)3; Te4.17 = 
Ficure 3.4.2-A 
fortran fac (£0) 7 
ocil IFCJ) 390 200 200 
é 
+ 
O02) ERR CS ILLES aAL LABEL 02) ERR 13 SYNTAX 
ERR 22 UNDEFINED LABEL 
40 : 
£(90008); T=6.07 
Figure 3.4.2-B 
fortran fac.subl sub2 (go. map orint) 
ny; 726.25 - 
Figure 3.4.2-C 
orinift fac listing 
FORTRAN / G LEVEL 6, #50 0 FAC DATE = 57030 “48/39/57 
PELE SAC : CAMBRIDGE MORITTOR SYSTEM 
GOG02 ° REAL*8 X,Z/.9074/ c FACOOCLG 
GO62 1 FORMAT tG7. Ny FACEEIZO 
95> 2 oe ‘a FACTORIAL 1S ',615.93 FACGOGSS 
foah 5 RMAT () DNVALID ARGUMENT!) FARQGONG 
nao5 & FORMAT it QVERFLCY ON',14,7TH ITERATION. ') FACIUGSE 
99906 5 FORMAT Cera ER 8 REAL NUMBERS SIRSEYS OR O TG QUIT.') F/AECOCSS 
O07 100 URITE (6,5) FACTOCOTG 
C553 105 READ (5,1) A FACOGDSS 
o009 v=A rFACIGESS 
vena 4=,1D1 FACONICS 
Gods IF (J) 300,209, 110 rACOOLIC 
COL 110 DO 129 J=1,J aaa FATOGI29 
ery X=Kel Are FACOOL3G 
OOR8 IF €Z.LE.X) GOTO GAD FATOOTNY 
et et, 120 CONTINUE FACGOL5SO 
vO45 WRITE (6,2) XK FACOOLEG 
Oui7 GOTO .105 FACOGLTS 
9045 200 STOP 5 FACOGISS 
thtbaen 300 PRINT.3 . FACOO0199 
GO2G SOTO 100 . FACCO200 
ODA $00 WRITE (6,8) 1 "ACOO2Z1G 
922 GOTO 100 FACO0226 
GO25 END . FAC00230 
FORTRAN TY 5 LuVEL €, HOD 0 FAC DATE = 67966 14/35/57 
File FAC a CAMBRIDGE MCNITOR SYSTEM ; 
. SCALAR MAP . 
SYMOCL LOCATION SYMBOL LOCATION SYMBOL LOCATION YMBOL LOCATION 
a C8 X D0 : A Ds 3 DC 
; SUBSPROGRAMS CALLED 
SYEGOL LOCATION SYMBOL LOCATION SYMSOL LOCATION SYMSOL LOCATION 
_ ingore Ek gh, of yes ee 
7 . FORMAT. STATEMENT MAP : On Ea eee See tenes Sen ie 
SYMSOL LOCATION SYMBOL LOCATICN SYMBOL LOCATION SYMBOL LOCATION 
i E8 . as £0 ps i102 A 117 
TOTAL MEMORY BERS REE TS OG02EG BYTES 


5 


FACO011¢ 


FACO0110 

ges 
mes 
aed 
Cee 
ca 3 
va 
Se 
SS 

PAGE 6Ly 

Gs 

DS 

S 


PAGE 600 
SYMBOL LO 
i 


SYMBOL LO 


oe Lye L 


SYMBOL LO 


Py, 


ole 


NVULUOA 
9-2.° FE 
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Error Messages: 


E(00001) TOO MANY LEFT PARENTHESIS, 
More than one left parenthesis was found in the command. 
No conpilation was started. 


E(00001) LEFT PARENTHESIS MISSING, 
An unbalanced right parenthesis was detected. No compil- 
ation was started. 


E(00001) NO FILE TO BE COMPILED IS DEFINED. 
No filename was specified in the command. No compilation 
was Started. 


E(00001) UNABLE 'TO COMPILE MORE THAL 32 FILES IN ONE RUN. PLEASE 
SPLIT YOUR RRQUEST. 
More than 32 filenames were ‘specified in the command. 
Enter in groups of less than 32 in two or more commands. 
No compilation was started, 


E(00001) AT LEAST ONE OF THE FILES TO BE COMPILED DOESN'T EXIST 
OR DOESN'T HAVE A ‘FORTRAN! TYPE NAME, 
“filename FORTRAN *" was not found in the file directory. 


E(60001) AT LEAST ONE OF THE FILES TO BR COMPILED HAS LOGICAL 
RECORD LENGTH DIFFERENT OF 80 BYTES. 
Recreate the file with 60-byte records. The EDIT command 
will truncate overlenqth records to 8&0 bytes. No 
compilation was, started, 


1:(00004) ; 
Possible errors were getected in the source program, but 
successful execution is possible. 


“-E (00008) 
Errors were detected in the souxce program, execution may 
fail * 
E (00012) 
Serious errors were detected in the source program, 
4 execution is impossible. 
£ (00016) 


Terminal errors were detected in the source program, 
compilation was terminated, 


E(00016) ERROR WHEN LOADING THE IEYFPORT MODULE. 
Loading of the compiler failed, no compilation was 
started. Retry’ the command. 


E(00032) COMPILATION CANCELLED DUE 19 SOURCE PROGRAM ERROR(S). 
CMS cancelled processing. Correct the source program, 
or specify the GO option. 


7-19-68 
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Sequential 1/0: 


All sequential files used or created by FORTRAN programs have 
file identifiers in the following format: 


r — oe om oe am Gr oe Ow te om mY at Re me te me me me mee we me we te 2 
; t , 

' Filens t” Piete 
, Filename Filetype - ; 
: —-—— hm me Oe me oe ete i me ee oe ee ee ee me me ™71 

FILE FIxxFyyy : 
fee de ooo oot ee Memes oe eee ~ 
xx is the data set reference number, from 


0} through 14, 


yyy is a sequence number, bepzinning with 001, 
used to distinguish multiple files under the 
Same data set reference number. 


Ifa file is being created by a FORTRAN propram, the fileniode 
will be PS. For input toa FORTRAN propram, any appropriate 
filemode is accepted. 


With the exception of terminal input and output, all files are kept 

on the permanent disk or on tape. existing input files must confarra 
to the record formats described below. Oufput files will be created 
by the FORTRAN program, and need not be defined before execution, 


Data set reference number 5 is reserved for terminal input records 
of 80 characters or less. Number 6 is reserved for terminal output 
records of 120 characters or less. The terminal is also addressed 
by statements of the form "READ b, list™ and “PRINT b, list™ where 
"b' is a FORMAT statement number. The FORMAT for a PRINT 
statement must allow a leading space for a carriage-control character, 
or the first character of the record will be lost. The carriape- 
control character docs not have to be filled in, however.: Output 
records generated hy a statement of the form "PUNGH b. list" are 
placed in a file on the permanent disk under the identifiers “FILE 
TOTO} PS". Actual punching out of cards may be performed 
ater with the OFFLINE PUNCH command. : ‘ 


Data set reference numbers }] and 1Z are reserved for tape 1/0. 
Number 11 corresponds to TAP] at virtual address 180 and number 
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12 corresponds to TAP2 at virtual address 181. Before number 
11 and/or 12 are used, virtual 180 and/or 181 must be attached 
to the user's virtual machine configuration, or I/O errors will 
occur, | 


With the exception of data set reference numbers 6, 8, 12, and 14 
which allow 133-character records and data set reference number 

9 which allows 140 character records, all files must contain 80- 
character fixed-length records. The implied record format and 
device for each data set reference number is shown in Figure 
a a 


The sequence field of the filetype is always "001" unless multiple 
files are referenced under the same data set number. There is 

no limit. to the number of files which may be created or referenced 
under the same number, but only one may be referenced at a time. 
The first used must have the filetype FTxxFO0O1, the second 
FTxxFO02, etc. The END FILE statement closes the file currently 
in use, and the next READ or WRITE specifying the same data set 
reference number will refer to a file with a reference number 

one larger. If the latest operation on a logical unit was a 

read (write), then an END FILE to that logical unit will cause 

all records to be erased on the current logical file of that 

unit that are beyond the last one read (written). The REWIND 
statement "repositions" the files to the first one used in that 
program under that data set reference number. See Figure 

3.4.2-F. The BACKSPACE statement is not supported under CMS. 
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344.2.1-+3.1 
FORTRAN 
Data Set External Record a Internal 
Ref. No. | Filetype Length Reference 
erred ati ean an ae ee ee 
i 1 ! 
21 | PT21Fyyy L 80. L_-_same as 1-4 
Foe Pot g ae ek ergs Ge iat ete eee oe 1 So 
{ 1 ! 
ee 2 nee | rt: 121 55'0'4: a, EE, ° 0 en p_---same_as_ 1-4 00 
i i 1 
I \ l 
wan 23 4---~----FI23Fyyy____| -----89 pees ,----Same_as_1=4 ee CEE Oe oe 
i ! } 
Eee: 4. ee Dee e228 YYy_———+-----82 oe r----Sane_as_in4 ee eee 
i 
I I j 
25 FT25P 80 same as 1-4 
EST a eC Bee re oer ge eee he eae m ee  e 
tate eta | ree FT26Fyyy____t___- 80. _t_same as 1-4 0 
I i i 
! I | 
boss BE erase Wiehe Sate EES DEY oe oe 2 BOL SBMS: SS ek 
1 op \ 
{ i 1 
1: ae ee ee eee 32) a's a, ee B08 | 8: ng: eee 
| i I 
{ 1 I 
poeple J Saad ; ae eee Ere SEYYY_———) stirs BO _--—-2p----Sme_as_in4 eRe ae Cane 
Bet Oe beached ee ee FT30Fyyy tf go. i same as 1-40 
*a is the data set reference number. 
b is the FORMAT statement number. 
list is a series of variable or array names. 


See the FORTRAN IV Language publication for additional 
acceptable I/O statement formats 


Pe ee eee SO PONTE SOREL! APO ON pe ten CaaS RTE DORE: DE RMR (Read LEME B 


A EE a SN EE ES ee SE GY RAY ED SR AE NR SE GE emcee Pl OD GOED BRE GETS SD TOE Gm igh HET SAN ROG BOLe nee tome GME OO GEV Soca OE thier SOE RN Stee fA GENS EE UD ROD MNES MN GT SDT ene! Genny meee NET CNS GamD Stn SLOR GENS Gey RT SG GOERS ONE SEED Gyn aw MD mt SE Sue mnt eT SEES 


Figure 3.4.2-E, Summary of record formats and I/O statements 
for sequential FORTRAN files. 
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12 corresponds to TAP2 virtual address 181. Before n 
and/or 12 are used, virtuaN{80 and/or 181 must be ere ied to the 
fll occur. : 


user's virtual machine configusation, or 1/0 aA 
8 













36, 8, 12, and 14_ 
reference number 
“ies must contain 80- 

ied record format and : 


With the exception of data set raferaace number 
which allow 133-character records a 
9 which allows 140 character records, 
character fixed-length records, The ir 
device for each data set reference ny 


The sequence field of the filetyge is always "0 
are referenced under the sz There is no limit 
to the number of files whfch may be created or referenced under the 
same number, but y one may be referenced at a =Tk002, first 
used must have the filetype FTxxF001, the second F'Lx* 002, ete. 


he END FILMI statement closes the file currently in use, nd the 


"unless multiple files 
ye data set number. 


next READ or WRITE specifying the same data sel reference number 
will refer to a file with a reference number one larger. The Ri! WIND 
statement "repositions" the files to the first one used in thal program 
under that data set reference number. See Figure 3,4.2-F. The 
BACKSPACE statement is not supported under CMS. 


; shown in Figure 3.4,.2-E, 
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fF Oe SS em, kk ki ae mers Sn yi 8 |v mw n'a 0 ‘rota nen 


















-acceptable 1/0 statement formats 


a ' i 

; Data Seti External | Record | Internal ' 

; Ref, Nos Filetype : Length ' Reference 4 

. 1 

' mee a aa SU OSMN Ak R aa  e  greemaa e Paw eee eee nt 

' Hic at FTO yy ‘ “ ! 

Vann nn wnn ee eee ait - ' 

' 2 3 Fr02ryyy READ (a,b) lists/ : 

pro ceeestden, i ere WRITE (a,b) hi , 

: 3 0 FTO3aryyy 1 END FILE a ; ; 

prone nena ee Cree 1 REWIND a : 

' 4 1 FTO4Fyyy ' : 
4 

ears we tedeien- Sendcecetcs hecoches secede rhcu sane saiesseansece nse 

i a: At - b) ist or READ b, list ‘ 

} eee ee fe necennne eee ans Se rea es ee SO ee Sareea nae em me ow me www new we a 

/ 5 | FTOSFyyy : 

Honeee we dee ee tne ene een wen enna cuesebeonie shade cus 

! 6 \ =P TE (6,b) list ‘or PRINT b,list ¢ 

pene eer Se eee he eee adc eae 

7 ! WLO’Fyyy 1-4 or PUNCILb, list ‘ 

PO tRS pees ede Sauce veges snes ence Cony cae eemacmnasirs capaci ae eer 

$s FTO&Fyyy ‘ 

St steel Nelo eee eee ta cag Lacuuce Weweed ogo li i ete eee eee Gee : 

7 4 aoa 

' 9 ' FVoobyyy % ' 

tonne ee nee 1 Ce deet ch eneunentin eecanuhas won eetes Vetean 2eeesceas Seamcs es ~-4 

' 10 i FT10F yyy ‘ 

eae SRE RA EAE ROUEN St SO RMS ERY DRONE Werte TaN EAC : 

1 i 

' 11 1 “+ ‘ 

‘ ry : ‘ 

Lan enngine Horeenns eh oe tit! cere. Chet wecececrece 4 

‘ 12 ‘ “+ ‘ 

t 1 i 

ee wm Pr Re me er we Oe ee ot ow ne mm we me oe we re me me we me tte ee ee wm a ee ob 

t 

13 ~- : C ‘ ;. same as 1-4 ' 

{ { 3 
aia Peis dee ‘ae sr orig as Carte a oars Genre 
14 133 ame as }]-4 

wenaitey Nheuigetn of a deblockea 10 72 cs : 

a data set reference number. : 

1 

Uj 

b 1¢ FORMAT statement miunber, ' 

s 1 

' 

list s a series of variable or array names, i 

: iy t 

See the (FORTRAN 1V Language publication for additional 

' 

i) 


ee ee ee ees 


Figure 3,4.2-8, Summary of record formats and I/O statements 
for sequential FORTR AM files, 
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ee 3.4.2.135 

345 . | FORTRAN 
7-19-68 3/5 3 $6 
3.4.2, 1-4 af ; : 

FORTRAN poccenene He iieeciew Auda ian dees penne nnn een enn e ne eecennae ; 

FORTRAN PILE- 

i STATEMENT i NAME TYPE MODE \ 

{ 


Notes: . + 2 Sue leon ee ie eee set es co ne ans te oe ee ed on ne et a me 
. REALt8 B(5) 


1. The file identifiers for cach of the fi 100 FORMAT (5 (G10.8,6X)) 
rs for each of the filcs are: 5 pO 20 I=1,45 
READ (4,100) B FILE FTO4FO01 Pl 
FILE FTxxFyyy " . a 
where "xx! ig the data set reference number and "yyy" is the 20 WRITE (3,100) B FILE FTO3Fr001 P5 
sequence number, 30 END FILE 3 FILE FTO3FOOL P5 
40 READ (4,100,END+50) B FILE FvO4roo1l Pl 
2. The sequence number is "001" except when multiple files are : | 
referenced under the same data sect réference number. 44 WRIVE (3 100) B FILE FTO3F002 P5 
; pu 
3 pear ee GO TO 40 
. No file identifiers are shown for reading data set reference 50 END FILE 3 FILE FrO3F002 PS. 


number 5 or writing number 6, since these numbers address 
the terminal for input and output, respectively. No file iden- 


52 REWIND 3 


tifiers are shown for data set reference numbers 11, 12, 13, . ; 
and 14, as these numbers address virtual tapes 180-183 respec- 75 READ(3,100) B PILE FTO3F001 P5 
tivel . ‘ ° 
82 PRINT 200,B (terminal output) 
we Data set reference numbers 13 and 14 should not currently be STOP 
_ used, as there are no definitions in CMS for tapes 182 and 183. li bac doe eee deeeeeenes bo aecdeeseshasnseeeseen cae tense eee 
Figure 3.4.2-F. Files referenced by sequential FORTRAN 
I/O atatements. . 
i : Note: 
= Statement 10 xeads the first 45 records of the existing 


file "FILE FfT04P00) Pl". At statement 20, these records 

ace placed in a nev file "PYLE PTO3POC1] PL". This file 

is closed by the END FILE statement at 30, and the next 

time data set reference nuwber 3 is used, at statement 

44, a second new file is created: “FILE PTO3F002", After 

the REWIND statement, data set reference number 3 is again 

: - associated with the first file created: "FIVE FTO3F001". 

, Note that the PRIN’ statement requires a different FORMAT 
statement, which will allow for a carriage-control character. 
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Direct Access T/o: 





All direct access files used or created by FORTRAN programs 
have file identifiers in the following format: 


Ce ee 


| Filename H Filetype H 
L L ( 


L-----— Ugabwwoek eee mI 
FILE DAxx 
xx is the data set reference number, 


from 01 through 08. 


If the file is being created by a FORTRAN program, the filemode 
will be P5. For input toa FORTRAN program, any appropriate 


’ filernode is acceptable. 


“Direct access" refers only to those files which are used 
with the DEFINE FILE statement. Files used sequentially are 
not considered direct access files, even though they reside 
on disk. ; = 


Unlike the sequential data set reference numbers, the direct 
acccecs numbor does not. implyany..vecord length, This information 
will be supplied by the DEFINE PILE statement within the 

FORTRAN program. All files are on the permanent disk. The 

same data set reference number may not be used for both 

a sequential and a direct acccss file in the same program, 

nor may a Single File be referenced by both methods in the 

Sama program. biffercnt access methods may be used for the 

same file by different programs, provided the file identifieys 
are changed. : 


The number of records specified in the DEFINE FILE statement 
should be realistic. If a new file is being created, the 
specified number of records are blanked out on the permanent 
disk before the first record is written. Specifying an 
unnecessarily large number of records wastes disk space. 


Although the FIND statement is supported, there is no need 
to use it in a time-sharing environment. I/0 overlap is 
achieved thropgh sharing of CPU time among the virtual 
machines. Use of the FIND statement will actually slow 
down execution of the FORTRAN program slightly, since 

two operations must ba carried out instead of one. 


An example of. direct access IYO is shown in Figure 3,4.2-G. 
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FORTRAN 
: Be wy aa 
fe en eS ee ane an ee es ee oe RL Oe ie ee a oem mm ees ted se oY ond ae oF an we cw OO aay On oe On ae ee as ee 
' FORTRAN : 4 
' : 7 i FILE~- ] 
{___STATEMENT eer 1° NAME TYPE MopDE ! 
fem a a a a am oe om at a ow (0 a0 tam es ne nn Yan td eh ve ca we eam ame 00 a wa We ene oe 08 ww ane em men ow’ joie al le ide atin t 
1100 FORNAT(T6,2X,A20, 4613.6) H 
DEFINE FILE 1(200,80,E,R3) i 
1 - 
ex | 
5 READ(1'J,100) MNNO,NAME, TOTS . i 
; oo FILE DAO1 P ' 
30 WRITE (1'3,100) MNNO,NAME ,NWTOTS _ : 
i - 
STOP 


ee ee He ew ee me me wee Oe eae oe ean 
TO A Ae OS eS a Le OS eae hw Set Na Oe a Se es me tae ee ew en 


Figure 3,4.2-G. File referenced by ai 
. . 1rect 
I/O statements. : ya aoa 


ee Oe et ae Oe we me ee ee me 


Note: 


The DEFINE FILE statement describes a file of 200 80-character 
records, If this file had not existed prior to progran 
execution, 290 records of 80 blanks would have been written 

on the permanent disk. Statements 5 and 30 read and write 


the J'th record, where J has b si i 
value less than 201. i a a 


20G 7-19-68 z 
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‘ : ef 
/ Additional Notes (continued) 
Additional Notes: Gge ar phen seagrass Sy Ny 
: 2, The FORTRAN command does not produce a listing file unless requested. All 
1. The supported data set reference numbers, device assignments, diagnostics are printed on the console unless suppressed by the option NODIAG, 
or record formats at.a particular installation may vary from ‘ To obtain a FONYRAN listing. file the options SOURCE, MAP, or LIST mv3t be 
those described. Check with the responsible system programmer. specified and only those options requested will be included in the listing file. If 
; a listing file is produced, the diagnostics will be included. If only the option 
2. Since different FORTRAN programs using the same data set _ NODIJAG is specified, a listing file will be produced containing only the FORTRAN 
‘reference number will reference the same CMS file identifiers, diapnostics, The PRINT option directs the listing to the printer and wil] print 
files should not be left on the permanent disk under FORTRAN only those parts of the listing requested by SOURCK, MAP, or LIST. Wf PRINT is 
format identifiers. If a FORTRAN program is to be executed the only option specificd, only the diagnostics will be printed. : 
repeatedly, it is advisable to create an EXEC file renaming 
execution-time files before and after execution. An example 3. Kach FORTRAN file can contain any number of routines to be computed. 


of such a file might be MYSTRUP EXEC P5, containing: 
4, The characters appearing in columns 73-176 of TEXT files generated by FORTRAN 


ALTER MSTR LIST Pl FILE DAO2 Pl are as follows and are followed by a sequence number in columns 77-80: 
ALTER CHANGES LIST Pl FILE FTO4F001 Pl 
$ FORTMSTR ; a) : 3 is oe ‘ . : , 
et a) for a subroutine - the first four letters of the subroutine name 
eat FILE FTO4F001 Pl CHANGES DONE Pl b) fora main program ~ the first four letters of the filename if 
LTER FILE DAO2 Pl MSTR LIST Pl ; it is physically the first deck in the file; otherwise, the 


A letters MAIN, 
The command "$ MYSTRUP" will then rename the files, execute the ane 


FORTRAN program, and change the identifiers again on completion. 5, The letiers used for columns 73-76 of a TEXT file will also appear in the rniddle 
: of the first line of each LISTING page. In addition, the name of the file will appear 
at the beginning of the second linc of each page in the LISTING file. 


6. The FORTRAN logical files which are defined are as follows: 


Logical Files Record Length 
" 1-4 80 character records 
: 5 80 character sysin records 
“ 6 -130 character sysout records 
7. 80 character records 
8 133 character records with carriage control 


To print the logical unit 8 file generated as FILE FT O8F00}, the OFFLINE 
PRINTCC comrnand must be used, : 


7. The subroutine DSDSET can be called to enable a user to change the record format 
5 and the logical record length for FORTRAN disk files. Thus, a uscr will no longer 
: be confined to records of 80 or 133 bytes in length. Refer to section 3.7.1.7 for a 
description of the DSDSET routine. 


8. A facility for accessing disk files froma FORTRAN program as a direct access 
file has been provided, This provided an efficient way ‘to update records in place 
and to access records randomly. A call to the DEFINE routine is required to 
define the correspondence between a CMS file and a FORTRAN data set reference 
number. Refer to the description of the DEFINE routine (3. 7.1.6). 
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A FORTRAN reread facility is available to perform a core 

Ifo format conversion. To use this facility, a call to the 
REREAD routine must be made to specify the logical unit number. 
The logical unit may be any unit from 1 to 99 except unit 5, 6, 
or 7. The FORTRAN statement 


CALL REREAD (n) 


sets the reread unit te logical unit n with a default record 

size of 140 bytes. This may be changed by specifying the record 
size as a second parameter in the call to REREAD, e.g. CALL .; 
REREAD (99,80). Refer to the subroutine description in section 
3.7.1.5. To read the record from the reread unit a second or sub- 
sequent time, a REWIND n or BACKSPACE n statement must be executed 
before the READ statement. If a. reread is issued without executing 
a REWIND or BACKSPACE statement, an END OF FILE condition will result. 
Any input/output statements for other logical units can be issued 
between a write and a read on the reread unit. The reread unit 

or the blocksize can be changed by another call to the REREAD 
routine. 


A CMS namelist facility is available for obtaining input to a 
FORTRAN program in free format without specifying variable names. 
Refer to section 3.7.1.9 CPNMON/CPNMOF for a more detailed 
description of this namelist facility. 


A facility has been added to change the identifier FILE FTxxFyyy = 
required for FORTRAN disk file reads and writes. A call te the 
DEFINE subroutine is required to change the correspondence 
between a CMS file and a FORTRAN data set reference number. 

Refer to section 3.7.1.6 for the DEFINE subroutine. 


FORTRAN has the ability to read a file from the T-disk during 
execution of a program if the file does not exist on the P-disk. 


10. 
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FORTRAN write statements can be used to create disk files with a name of 
FILE FTOxFOOy where x is the logical unit number and y is the logical file 
number, ‘The first tine a write is issued to logical uit x, logical file lis Ul. 
written, After an ENDFILE to logical unit x, subsequent writes to logical unit x 
before a REWIND will write into file FTOxF002, WVhis file is a scparate disk file 
from file FTOxF00], Additional logical files can be written by issuing an END 
FILE to the previous logical file and then cortinuing to write onto logical unit x, 
If a file already exists when the write statement is issued, the lines written are 
appended to the existing file. To append information to an existing logical file 
2, first : 

a) write onto Jogical file 1 and issue an END FILE x, or 


b) read the file until the end file condition is reached | 


then write into logical file 2 which will append to the data on the end of the 
existing file. 


After z rewind to a lopical unit, subsequeat writes will overwrite the existing file. 

Only logical file ], i,e., file FTOxFOO1 can be overwritten, There is no way to 12, 
overwrite into logical file 2, etc. An overwrite does not shorten the file lenpth; 

thus, informption in a file which is not overwritten will remain in the file. Writing 

over an existing file can lengthen the file and thus eliminates all the original infor? 
mation in the file. To write a completely new file, an existing file must first 13, 
be erased cither by issuing the ERASE command or by calling the ERASED routine. 


A'tape facility for FORTRAN programs is available where logical units 11-14 are 
the standard logical tape units. These units correspond to symbolic devices TAPI- 
TAP+4 and to virtual devices 160-163, <A tape file can be written in one of the fol- 
lowing five tape formats: 


type 1: fixed record size, unblocked 
type 2: fixed record size, blocked 
. type 3: variable record size, unblocked 
“type 4: variable record size, blocked 
type 5: undefined record size, no blocking 


The default scttings are as follows: 


Virtual Symbolic Logical Block Format Logical Record 
Device Device Unit Size Type Length 

180 -TAPI 11 80 1 80 

18] TAP2 12 133 1 133 

182 — TAPS 13 800 2 80 

183 TA P4 fo 14 1330 2 133 


Unless otherwise set by a callto TAPSE'T, the mode setting for 7 track tapes is 
for 800 bpi, odd parity, converter on and translator off. For 9 track tapes, the 
mode setting is ignored. Refer to section 3.7.1.1 for a description of the TAPSET 
routine, : 


Note: TAP3and TAP4 are not currently defined in CMS, therefore do not use 
Yogical units 13 and 14. 


‘A CMS namelist facility i 


z 
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te 


ade to specify the 
lto 99 except unit 5, 6,. 





















A FORTRAN reread facility is aw? 
To use this facility a call to the RE 
logical unit number. The logical unit ma 
or 7, The FORTRAN staternent 


scts the reread unit to logical unit n with a default 
may be changed by specifying the record size as a 
REREAD, ce p., CALL REREAD(99, 80), Refer 
section 3.7.1.5, To read the record from the 
time, a REWIND n or BACKSPACE n statemcpyt must be ex 
statement. If a reread is issucd without exécuting a REWIND 
statement, an END OF FILE condition wiW result, Any input/Agutput statements 
for other logical units can be issued bgvcen a write and a read dy the reread 
unit. The reread unit or the blockge#e can be changed by another wall to the 
REREAD routine, : 


ord size of 140 bytes. This 
Sond parameter in the calito 
ubroutine description in ~~ 
a second or subsequent 
uted before the READ 
or BACKSPACE 
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Vailable for obtaining input to a FORTRAN program 
in free format without pfecifying variable names, Refer to section 3,7.1.9 
CPNMON/CPNMOE Sr a more detailed description of this nameclist facility. 


A facility has been added to change the identifier FILE F'YxxF yyy required for 
FORTRAN disk file reads and writes. A call to the DEFINE subroutine is 
required to change the correspondence between a CMS file and a FORTRAN data 
set xefercnee number. Refer to section 3, 7.1, 6 for the DEFINE subroutine. 
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3.4.2.1-12 3.4.2.1-13 
FORTRAN FORTRAN 
Comma-delimited Input: If the following line is entered as input: 
Under standard Fortran I/O using numerical formats, variables 17, 43, 81, 
must appear within the field specified by a FORMAT statement 
in order to be read in correctly. However, under CMS, the I=17, J=43, and K=81 after the READ statement is 
user can effectively override the data-positioning requirement executed. 


by separating the data items with commas. Comma-delimited 
input may be used with I, E, F, G, D, and Z format specifications. 


Comma-delimited input is processed in the following manner: 
Fortran begins a character scan on the numerical field. Poor rnc cree renee ene eee say 
Scanning continues until either a comma is encountered or 

the number of characters scanned is equal to the field width 


specified in the FORMAT statement for that variable. If a A=3.4 
comma is encountered, the characters examined from the B=62.5 
beginning of the scan operation, not including the comma, are C=19.0 
read into the associated variables. If the end of the field D=37.8 


is encountered, the data item is read in as usual, Scanning 
resumes at the character following the comma or immediately 

. after the last character of the preceeding field. The entire 
operation is repeated until the I/O list has been satisfied. 


READ (5, 100) A,B,C,D 
100 FORMAT (4F5.1) 


The user is cautioned to allow a field width specification 
large enough to contain the value and the comma. A field 

width of zero causes nothing to be read into the variable, 
i.e., its value remains unchanged. If the first character 
examined is a comma, Fortran under CMS interprets the If the following line is entered as input: 
preceeding field as having width zero. 


[root ec enn n none nnn n ee 
Se ee ea eae 


121,6483,33454,98, 
Notes: Comma-delimited input may not be used with A or H 
format specifications. A=12.1, B=648.3, C=3345.4, and D=37.8 after the READ 
Statement is executed, Note that the third value 
Examples: has a field width of 5, and the next character 
Soe ene mena mmmmnnnmmwmy examined for variable, D, is a comma. Fortran 
1. : ‘ assumes a null field and reads nothing for D. 
I=2 
J=4 


K=6 ; 


READ (5, 100) 1,J,K 
100 FORMAT (315) 
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: Bagnise 
oie t permanent disk. “of pe . 
3.4.3  PLI US ND suppresses the TEXT file. GUY 
3 | S03 
Purpose: : ; oa : c ' causes corpilation to proceed after conpile-tine processing 
has been conpleted, 
nC. Suppresses compilation. 
The PLI cermand conpiles programs written in PL/I source 
language into nachine oes and frovides program ; 
listings and diagnostics 4 indicates that compile-time processing is required, 
ay causes the compile-time preeesscr tc be bypassed. 
Format: ‘i 
; ‘ S2 includes input to the compile-time processor in the 
LISTING file. 
eae ae fo ee eee See pean Re ee ae ans Fe ‘ NS2Z Suppresses listing of input to the compile-tine processor. 
{ PLI [filenane 1...filename N (option 1...option N){ 
! j : { ST produces extra code allowing executicn-time diagnostic 
SR cas soy aria eee ee Sey SS DETAR Se tae «el ae oe messages to contain statement numbers in addition to 
: offsets relative to entry points. 
. ‘ £3 includes cnly offsets in executicn-time diagnostic messages. 
filenage 1...filenane N are the names of PLI 
files te be cempiled. 
A separate corpilation EE. indicates that source program is in Extended Binary Ccded 
vill be performed for Decimal Interchange Code. 
each filenane specified. | B indicates that source program is punched in Binary Coded 
, Decinal. 
eftion 1...option N are one of mare of the 
compiler opticns described €69 specifies that a 60-character set is availatle 
below. on the offline printer 
: C48 specifies that a 4@-character set is ayailable 
. ‘ : aa on the cffline printer, 
frticns: 
3 ; ci ER specifies that warning, ercor, and severe error messages 
5 includes the source prograsp in the LISTING file. are to appear in the LISTING file. 
NS Suppresses the listing cf the scurce pregram, FE specifies-that cnly error and severe error aeSeagee are 
to appear in the LISTING file. 
‘ FS specifies that cnly severe error messages are to appear 
L includes a listing of chject code in assembly in the LISTING file. 
language gnemonics in the LISTING file. 
NL Suppresscs the chject code listing. 
; E. provides a larger external dictionary 
NED uses nornél size external dicticnary 
A includes an Attrikute Listing in the LISTING file. : 
NA suppresses the cbhject ccde listing. 
NT a block level and iterative DO level are printed 
: after the appropriate statenent. 
E includes an External Symbol Dictionary in the LISTING file. - KAT suppresses printing of block and DO levels. 
KE Suppresscs the listing cf the External Syibcl Dictionary. 7 
cL the oapticrs in effect for this ccrpfilaticn are 
x .kncludes a Cross Neference Listing in the LISTING file, printed in the LISTING file. 
NX Suppresses the Cress Reference Listing. 4 NCL no option list is printed. 


“E creates the TEXT file of object code on the userts : Ihe following cytions relate to the CMS control of compiler cutput. 


05/01/63 
. ‘ , 
Abbreviations for each option appears in parenthesis. Sal ySe 3 


. é WED 


Yer 
outputs. the TEXT file onto the offline tis 


EUKCH 

{EU) punch. Cption "D" must be in effect. 

ERINT outputs the LISTING file onto the offline 

{P) printer. A copy of the LISTING file is 
not flaced onto the user's disk. 

NOEBRIAT no LISTING file will te produced 

(NB) 

NGDIAG compiler diagnestics are not typed on the 

(ubG) user's terminal. 


If neither F ncr NP is specified, the LISTING file will be placed onto 
the user's pernanent disk. 


Usage: 


* 


The PLI ccmmand compiles files cf PL/I source language into 
sachine-lanyguage cbhject code. Input files ‘must have a filetype of PLI 
and a record lergth cf 80 characters. 


compiler cperaticn and output are specified in 
any crder ina set of parenthese following the last filcname, Any 
coittinaticn cf cpticns is valid. When confliciting options «are 
spocified,.the last specified option will be used. Unsuprforted or 
gisspelled oftions are ignored. One seé€t of cpticns 
coupilaticns perfcrred by cne cecrmand. Each of the options has a 
default value- which is selected when none is specified. These 
defaults are underlined in the secticn cn Options above. 


The cpticns geverning 


Set values are specified for the following options, and these pay not 


be changed ry tke user; 
SIZE = 131(72 

This optica specifies the amount of core, in bytes, available to 
the conpiler fcr use during a ccnzilaticn. 


Le = §¢ : . 
This option specifies that ‘listings are to 
lines fer fage. 


be printed with 50 


c = 006 


The level cf cptirizaticn fer the ccmpiler is set at 0, meaning 
that the object-time storage requirement will ke kept to a 
ninisun. 


governs ali 


For 


C2E-6594, 
likcary". An 
"ELyYI Prinser". 


.E (00026) 
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3.4.3-4 
AE 
Hol. 


: Source statenents will be in 
beaning that cnly ccde within these wargins 


SMH = (1, 72) 

The deliniting margins for scanning 
columns 41 and 72, 
will be precessed. 


discussion 
"“PLy,1 Programmer's 
intreducticn to 


a complete of PL/I usage, trefer to IBH Manuals 
Guide" and C2€-6590, "PL/I Subroutine 
PL/I is provided in’ Manual C28-6806, 


4 


warning messages have been included in the 
: LISTING file, successful execution is probable. 


B(00C04) 


E (C0008) Error messages have heen included in the LISTING 
file. The ccnpilaticn was Couple ted with errors, 


and execution may fail. 


E (00012) S€vcre @rrar nessages have heen included in the 


LISYING file. Successful execution is improbable. 


- 


Compilation terminated abnorsally. 
“Successful executicn is impossible. 


£ (00016) 


E (00026) FILE TO BE COHPILED, undefined. 
No file with the specified filenane and filetype 
of FLI can he located on disks Check to see that 


such a file exists and then re-issue the PLI connand. 


FILE(S) TC BE COMNFILEL, no specified. | 
No filename (s) were specified in the PILI command. 
Re-issue the command in its proper format. 


E (00026) 


FILE HAS INCORRECT RECORD LENGTE. 
The source ccde tc be cempiled is not in 
80-byte record format and cannot be processed. 


E(00026) 


SYNTAX ERROR IN CPTION LIST. 
Verify format of option list in COMMAND line. 


af t 


y 
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F(00027) CMS NUCLEUS ERRCF, Re-ipl the CMS system disk. 
: sgtpiluticn Notes: 
B (00028) An @rror was encountered in attempting to : 
punch the TEXT file fer the froqram being Ae The main procedure must be ccmpiled with the 
cempiled. : : OPIICNS(MAIN) option stated, 


h. Compiler diagncstics must be examined carefully -- 
: lo not attempt to execute a program that has not 
4 . ; cotlpiled successfully. 


3 ‘ ce. Conversion Subroutines are noted as “warnings" in 

; tne Compiler diagnostics -- this does not indicate an 

error and shonld not affect the execution of the 

: ; procedure -= it merely notifies tne user of "costly" 

. converSions. Tne warnings may be suppressed by the "PE" 
i parareter, 


3, The ccnpilar will produce a file “name TEX? PI" 
from the input file "name PLI P1" except in the event 
‘ or "teriinal" compiler errors. 


4S uses the EL/1 Version 4& Subroutine Library. 
Qacause the total Library is composei cf a very large 
hutiber of subroutines, it has been necessary to divide 
it into threes separate files: "PLILIG1 TXTLIB", 

: WOLILLG2 TXTLIA", and "PLILIE3 TXTLIB", Three 
\, : : . additional subroutines have been added to the library: 

IdEChS, IHECLOX, and LHEFILE. 


¥ 


en we a ed ee ee IS 


Before leadiny a PL/I program it is necessary to. 
desigquate that the PL/I library is to ke used (the 
detault litrary is the FORTBAN library call2d SYSLIB). 
This may be: done immediately tbetore Joading cr 
Adtomatically at login via the PEOFILE &xeC by the 
Eollewiug CMS command: 


o : ; GLOBAL LOADER TATLIB PLILIB1 PLILIU2 PLILIB3 
Warning: I& the leader indicates that names of the 


form “IHzExyz" are underined the PL/1 libraries ware not 
cotrectly desijnated. 


Ine CMS Ccmmand Frocessor automatically converts all 


05/01/. 2 
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parameters on a command line into a series of 8  gzys%5 Wig 3.4.3,1-3 


Character fields (left- ‘justified and padded with = 2. Non-f£crmat Simple I/0 ; LLP 
blanks or truncated as necessary). These parameters Yop . For input/output that is not a simple character string, 
may be passed to the PL/1 main procedure with the main the PL/I conversions will often work adeguately. 


procedure in the form illustrated, 


ptogi: PAOCEDUKE (PAKMS) OPTIGNS (MAIN); 


DECLARE PAKMS CHAR(*) VARYING; @. DISELAY (VARIABLE); 
; where VAXLABLE can he any simple variable (i.¢. 
woen using parameter fassing only the two loading integer, floating point, character string,etc.), 
techniques descrited below may be used. it will be converted to a character string by 


default format and printed. 
1. LCGAD f¢rog1 <proyg2 ...> 


START LHLCMS parm? parm2 parm3 ... b, DISFLAY ('THE VALUE CF BK IS' ff N); 
: The value of N is ccnverted to a character string, 
2. LCAD proyi <prog2 ...> concatenated with the message "THE VALUE OF N IS", 
GENMOD ;rog and printed. 
« .- Cc. DISELAY (ENTER VALUE OF N') REPLY (INPUT); 
. N = INPUT; 
Frog? parm] parn2 parm3 ... The number entered is accepted as a character string . 


and cenverted to a numper by the "N=INPUT" statement. 
If INPUT contains an illegal representation for a 


fotes The varying character string PARKS will contain -humber, a CCNVERSION error will result. 
tae concatenation of the specified parameters. Its 

length will always be a multiple of 8 (or null if no 

FaLranaters are specified). 3. Full PL/I Format Capabilities 


Tne full PL/I format capabilitics cau be used by 

creating formatted strings using the GE? STRING 
fecainal 170 and PUT STKING commands. Kegular PL/I input/output 

utilizes the "LIST" or "EDIT" mode format control. 


Pecainal inputsoutput Gan best be perforn2d by using a. a typical output statement might ke: 
tne PL/I DISFLAY or DISPLAY/REPLY commands. Thongh the PUT FILE(SYSPKTAT) EDIT (A, By C) (F(8,0) 4 F(8,0), F(7,2)): 
CISPLAY/REPLY -facilitieés deal only with character To: accomplish the same function to the terminal: 
strings, all pessibie uses can he accomplished by the POT STKING(QUTPOT) EDIT (A, 6, C) (F(8,0), P(8,0), F(7,2));5 
Follewing techniques, : DISELAY (OUTPUT) 3 
; where OUTPUT is declared to be a sufficiently 
1. Caaracter Iso long character string. 
For sinple character strings, the DISPLAY/REPLY 
facilities are convenient to use, b. A typical input statement might be: 
GET FILE(SYSIN) EDIT (A, B, C) (F (8,0), F(8,0),. 
a. Output message only: F(7,2)) 3 
DISFLAY (message); DISELAY (* ") &EPLY (INPUT); 
Exauwple: PISELAY ("HELLO THERE"); GET STRING (INPUT) FDIT (A, B, C) (F (8,0), 
, F.(8,0), F(7,2))5 
he. Yutfut wessayo Collcwed by response: where INPUT is declared to be a sufficiently 
DISELAY (message) REPLY (response); long character string.. 


Exauple: DISPLAY (‘ENTER YOUR WAME') KEPLY (INPUT); 


where LNPUT 1s declared to be a character-variable,. igs_Via_ Files 


Cc. Input only: 


DISELAY (* ") REPLY (response); : - extensive input/output file capabilities are available 
Fxangle: YESELAY (" *) REPLY (input); in FL/I. FEresently, CMS has very limited support for 7 
PL/I File Iyv0O. Those capabilities will be briefly 


where 1NeUT is declare] to be a character-variable. jluscrived here, although the user should note that most 
: of the hundred of possible options and * especial cases 
have net been tully tested yet. 
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1. File Names OEE 
A’ reference toa file in PL/I requires the use of a 


“rilename". A filename of "DATA" in PL/I corresponds ta 
a CMhS file named "FILE DATA". Thus, the standard PL/I 
files SYSERINT and SYSIN correspond to the CMS files 
"“SILE SYSPHINT" and "FILE SYSIN" respectively. 


2. File Ceclarations 
ALL files must be declared ~~ 
characteristics of files under 05/7360 from either PL/I 
declaraticns or PP cards, and CMS does not use DD 
cards. The general form fer a declaration is: 


Since PI/YI learns the 


DECLARE filename FILLE <stream/RECORD> <CEXTERNAL/INTERNAL> 


<PHINTD> ENVIKONNENT (F (n))¢ 


where n is the length of each record in the file, 


‘Recommended declarations for SYSPRINI and SYSIN are: 
DEC LA BE SYSPRINT PILE STREAM PRINT ENVIRONMENT (F(120)); 


DECLABE SYSIN FILE STREAM ENVIRONMENT (F(BO)) ; 


3. File Operations 


At present only SECGUENTIAL files can be processed under CMS, 
though either the STREAM or RECORD torm can be used. The following 
companas may be used. ; 
a. OPEK 

“There is no real need for using OPEN as the 

'first GNT/VUT or READ/HYRITE to a file will cause 

it to automatically open. Since the OPEN routine 

is dynanically loaded there is urually a noticeable 

/pause when an OPEN occurs. At present the TITLE 

,Opticn does not appear to work under CMS. 


b. GEI/PUT 


Al) forms of GET/PUT can be used -- of course the 
>file must have been declared as STREAM. 


C., READ/WRITE 
Only the SEQUENTIAL forms of RFAD/WRITE can he used -- 
the £ile must have been declared as RECORD. 


d., CLOSE 
Before a file is switched from GFT to PUT, PUT to 
GET, READ to WRITE, oc WRITE to KEAD, it must he 
CLCSED. 
therefore writing 


Note: Files are not automatically ecrased, 


into an already existing file will result in appending reconds 


Yd. Oe 


to the end of the original file. There is one exception 


3.1-5 


the file SYSPRIN’ is automatically erased at the beginning i? 


of execution, 


Although the OPEN statement as not needed, due to the 
significant overhead associated with implicit ‘OPENs 
(caused by GET, PUT, READ, WRITE) as well as periodic 
preplems with the dynamic loadiny of the routines, it 
is recommended that all files be OPENed. explicitly at 
the beyinning ty a single OPEN statement. The form of 
the CPSN statement iss 


OPEN FILE (file1), FILE(file2), FILE(file3), ...; 


By BIESL wececver 


PL/1 attempts to “catch" all executicn ¢rrors 
invalid conversion, program 
input/output errors, and prints an appropriate message 
on SYSPKINI. The itessage that is placed into the FILE 
SYSPKIN? is also transferred to the user's terminal, 


such as 
interrupts, and 


scousiona tly the message eThterrupt in Ercor Handler" 
will occur. ‘This means that PL/I has teen unable to 
eecover £rem an error condition. There are three main 
causes for that phenomenon: (1) the compiler has 
jenerated jncorrect cede cr malfunction of library 
coutine - d.e. system error, (2) a subscript has 
exceeded its bounds and destroyed seme aibitrary area 
or memory ~ usually a ie of the proqram, or {3} 
parameters have been passed incorrectly (i.c¢. scalar 
instcad oof array) causing incorrect addresses to he 
used. The second problem can be avoided by enabling 
the SULSCRIPTKANGR check by making the first statenent 
or each sutroutine: 


"(SURSCKIPTRANGK) 2" 


PL/I will catch all proyram interrupts, 
breakpcints: set by the DEBNG routine. Therefore, if 
you wish te set breakpcints in a PL/I environment it is 
necessary to disable the SPIE that PL/1 uses to trap 
all interrupts. The SPIE can he disabled by using the 
special CMS library function IHNESPOF (SPIE of f) and 
anabled by the functiscn LHESPON (SPIE (on) « Bee oe 
should be placed so that they are 
SPIE has been disabled. 


including the 


= 


At present several PL/I 
Waltuncticn under CAS -- 


system-dependent capabilities 
the TIME and DATE huilt-in 


functicns and certain types of ON-conditions do not 
Operate cerrectly. There may be other similar 
teaporary limitations. The user should try to avoid 
ajing these facilities. 


Cccasionally it is desirable to use the full PL/I 
SET/PUT, LIST, EDIT, and LATA facilities with the 
user's terminal, Furthermcre, it is eften desirable to 
hive: programs that can use the terminal for testing 
with small guantities of data, but later use files for 
large-scale runs. A facility has keen added to 
CAs-PL/1 te specify that the SYSIN/SYSPRINT be directed 
to the user's terminal rather than files. It is still 
necessary for the user to declare the SYSIN and 
SYSPuIN}Y files, whether he is using files or the 
tertinal. ; 


Inere are twe mechanisms available fcr activating this 
mode OL cperation. : 


1. Jf the first parameter passed to a FL/1 program is 
"(TYPE)", it will be trapped by the interface routine 
anu cenoved trom the parameter list, the typewriter 
SYSIN/SSYSPRINT mode will he turned on, The remaining 
oarameters, if any, will be passed to the PL/I main 
peocelure. 


é. It. may ne desirable to selectively switch 
SYSIN/SYSPRINT from files and terminal. The CMS-PL/TI 
library routine INEONNL (online) will cause all future 
SYSIN/S(SPRINT requests to reter to the user's console, 
the routine LHEOFFL (oftline) will cause all future 
SYSIN/SYSPRINT requests to refer to the files FILE 
SYS1h and FILE SYSPRINT. The rost recent IJHEONNL or 
LubOFFL negates the aftect of any previous mode. 


Note that the normal precautions concerning GET/PUT 
apply. In particular, if both SYSIN and SYSPRINT are 
to be used, it is recommended that they be opened 
simultaneously by the statement: 


OPEW FILE(SYSLN), FILE (SYSPRINT) ; . 


PL/I_Suvroutines 


Three sukrcutines have kEeen added to the PL/I library 
ror use under CMS. Two of these -- [HFCLOK and IHEFILE 
-- were written to assist users attempting to write 
"“wonitor-type" programs in PL/I. 
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PEG Se 
S13 


IHECHS : FETE 


PULpQs 


ies] 


Intacas performs the CuS-dpendent initialization and passes 


parameters tc the primary PL/I initialization 


suncoutine, INESAP. 


Calling Sequence 


- 


LHECMS is automatically leaded with the PL/I initialization 
subroutines. 
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IHECLCK - PL/I Clock Routine cao, G BGG 


YS 


IN@CLOA reads the CP virtual chrenolog clcck and returns the 
water, time of day, elapsed virtual and total time. 


callin, Sequence 


‘ 
| 


CaLL‘LHECLCK ( CLCCK ); 


wbice CLOCK is a PL/I structure in the form illustrated 


Lelow. 
CECLARE 1 CLOCK, 
2 DATE CHAR (8), /7* date in forn 01/21/69 ¥*/ 
2 TIME CHAK (8), 7* time of day in forn 21274, 34 */ 


2 VIRTUAL_TIME FIXED #BIN(31,0), 
/7* elapsed virtual time in timer units */ 
2 TOTAL_TINE FIXED BIN (31,0); . 
( . . /* elapsed total cpu time in timer units *, 


QATE and “IME centain actual "/" and “." as illustrated in the © 
axanples above. The PL/I SUBSTR function can be used to rearrange 
th: CATE and TIME and/or remove the punctuaticn. 


VIALVAL_T1ade and TOTALLTINE are binary integers. They represent 
vlipsed time charged for cpu usage running under problem state 
("virtual time") and ‘clapsed time charged for tcetal cpu usage 
("total time"). To convert from timer units to hundredths of 
seconds, divide by 768 cr xX*3u0". Both times are increasing 
duvDers, the norinal 360 timer decreases. 


fhe tollowing is a very simple IHFCLOK test program. 


JESICLAS PRCCEDURS CETIONS (MAIN) 5 ; . TESO0010 © 
TESTCLK:. PROCEDUKE OPTIONS (MAIN) & 
i DECLARE IHECLOK ENTRY (1, 2 CHAR(8), 2 CHAR(8), 
2 FIXED BIN (31,0), 2 FIXED BIN (31,0))% 


DECLARE 1 CLOCK STATIC, 
2 DATE CHAR (8), 
2 TIMK_OP_DAY CHAR(8), 
2 TOTAL CPU_TINE FIXED BIN (31,0); 
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; : SBE 
“LOOP: } Wo 
DISPLAY ("BEFORE CLOCK.')3 
CAIL IHECLCK (CLOCK) ; 
DISPLAY ("AFTER CLOCKet)3 
DISPLAY (DATE) ;DISPLAY (TIME_OF_DAY) 3. - 
DISPLAY (VIRTUAL_CPU_TIME) ; DISPLAY (TOTAL_CPU_TIME) 3 
GO TO LOOP; 
END; 


ee Fee a ee ec ee ea a I SN ae Rae OE a ee I ee rare 
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INEFILE ~- PL/I File Access Routine LEED 
W7 


Pucpose 


Lifeile converts PL/I file access requests into the corresponding 
2-43 Commands STATH, BUASE, FINIS, RDBUF, and WRAUF. 


fz usec should be familiar with the operations of the above 
Nadad CAS Lile systen routines and the error codes produced hy then. 


CALL IdFRILE ( FCB) ; ‘ 


#hare FCU (File Centrol Blicck) is a PL/1 structure in the 
ccim illustrated kelow. ; 


LECLARE 1 FCR, 


2 CCNMAND CHAK(8), 7*CMS command desired */ 
2 PLLENANE CHAR (3) /* CuS Filename */ 
2 FILETYPE CHAK (8) /* CUS filetype */ 
2 CARLC_NUMBER FIXED WIN (31,0), 
: ; /* vecord number ~ RDOBUF/WRBUF only */ 
2 STATUS FIXED B1IN(31,0), 


; 7* CMS return code - 0 means OK */ 
2 CARL_PUFFER CHAK (80) ; 
7* 80 byte record to be read or written */ 


¥ 


The dv kyte record need not necessarily ke a single 
chicacter string. The next 80 bytes of the structure (after 
STAf£US) are used whatever they may be. Therefore, binary 
intejers, Character strings, fleating point numbers, etc. 
can Ea used in the following ways: 


(1) adding them tc structure in place of CARD_BUFFER, 


(2) defining another structure positioned on top of 
CARD_BUFFER, 


or 


(3) converting all information intc a concatenated 


character string and Separating out on input ky : 
SUBST&. 


CAIC_NUEEER must ke set for RDBUP/ARBUF usage, it is ignored 
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' 5 r S tial writing oF op 
STATE, ERASE and FINIS. If sequen ; oss 
aaiane Le to te done, the PL/I program must increment is MCE 
Cada QEPER. When writing, if the card already exists, 2 S/F 


aill be replaced by the new card, If the card did Ongar 
(ieu., the file is being expanded), the postion ey 
Mond-ot-ftileo" ig moved and the new card added to the file. 


3SPirus as the CMS return code for the last THEFILE toe 
using that FCB. For example, return code 12 ee a 
aidiicates an attempt to read beyond the current posits 

tne “end-c{-Lile" (see exanple that follows). 


ag] 


We 


The example that fellows dces the following things: 


e 
(1) iiases the rile "TEST1 DATA" if it already existed. 


(2) Creates a file "THST1 DATA" consisting of g5 ae are 
each record ccentains a character string day: at 
the square of the card nunber (i.e., the, third car 
in the file centains the number "9"). 


(3) The file is closed via FINIS. 
(4) Assuming the numbar of cards in the file is meee 
the program attempts to read through the file unt 


the status indicates that the “end-of-ftile" was reached. 


(2) The file is then read backwards (i-c. starting at last 
card,.then next to last, etc.)- 


(6) the file ,is closed. 
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in‘STFIL: PROCEDURE OPTIONS (MAIN); TESNGO10 
TESTFIL: PROCEDURE OPTIONS (MAIN) ¢ ZA 
me 


DECLARE 

1 FCB STATIC, 
COMMAND CHAR (8), 
FILENAME CHAR (B), 
FILETYPE CHAR (8), 
CARD_NUMBER FIXED BIN(31,0), 
STATUS FIXED BIN(31,0), 
CARE_EUFEER CHAR(80); 


NNNNN ND 


COMMAND="ERASE®; 

FILENAME="TEST1%; 

FLLETYPE="DATACS 

CALL IHEFILE (FCB); . 
- COMMAND= "WERBUF' 3 


pe I = 1 to 25; 
CARD BIFPER=I*I; 
CARD_NUNBER=IT; 
CALL LHEFILE (FCB); 
é DISPLAY (1¥*I) 3 
END; 


COMMAND="PinTs'; 
CALL INEFTLE(FCE); 
- COMMAND="REBUPRT: 


DO 1 = 1 BY 1 WHILE(STATUS=0) ; 
CARD. NUMNBER=T; 
CALL JHEFILE (FCB) ; 
DISPLAY (CARD_BUFFER) ¢ 
END; 


DISTLAY ({ STATUS ="]]STATUS) ; 
IAAX=I-1; 


DC I=IMAX YO 1 FY -1; 
CARD NUNBEK=TS 
CALI. LHEFILE (FCB) ; 
DISPLAY (CAED_BUEFFER) 3 
END: 


COMMAND=*FINISS 
CALL ITHEPILE(FCE) 3 
DISPLAY (' THATS ALL."); 
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3.4.4 SNOBOL:- ~ Yad 
‘Purpose: 


The SNOVOL command compiles source programs written in 
SNUBOL into SPL/1, and executes SPL/1 programs. 


Format: 


ea ene eer et 


en em a ee ee ee me ee tet mnt pete me er Se mem Ae ce eee ime ed 


ve t j 
| {snonon} fFilenane ftoption...optionn]] 


| AER, 


a ee re eR ee on tealiatineadl 


‘ filename specifies aceite with the filetype 
SNOBOL to be compiled, or. with tne 
filetype SPLi to be executea, 


* 


optiont...optionn are one*or more of the compiler 


options described below, 
Uptions: 


OFFLINE eitner of these options specifies that information 
PRIiny normally placea in the LISTING file is also to 
be printed offline. 


OhbIne specifies information normally placed in tne 
LISYING file is to be typed out at the terminal, 


NOLIS': | suppresses the LIST1iIG file, but does not affect 
either of the above options. 


specifies the file namea witn the command is 
an SPL1 file to be executea, and not a SNOBOL 
file to be compiled. 


Sit ; 


. 


In audition to tic options above, execution is also controllea 
by control carés within tne source file. These cards must begin 
with a hyphen in column 1 ana appear exactly as shown below. 


-LIisT ON resunes the listing of the SNOKOL source program 
in the LISTING file, This is the default value. 
-LISi OFF suppresses tne listing of the SNOBOL source 
program in tne LISTING file. 
~SiyvULNGL causes colunns 73-80 of the source file records 
to be ignored by the compiler, ah town card 
sequence numbers, 
-bLJLCT | inserts a carriaye-control cnaracter in the LISTING 


file to skip to a new page. 
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-ULCK generates a file “filename PUNCH P1" containing | 
the SPL/1 output in a special abbreviated format, 


eOGO suppresses execution of the compiled. program. © 


-MuitbER=name identifies tne following cards as an SPL/1 routine, 


“DATA marks the end of input to the compiler. This 
card must be present, whether any data cards follow 
or not. 


-ASSENBLY OFF suppresses listing of SPL/1 programs in the LISTING 
; _file as they are loaded for execution. This is the 
default value, 


“ASSLMLELY ON includes the listing of SPL/1 programs ‘in the 
LISTING file as they are loaded for execution. 


“TRACE causes all strings referenced by the user's program 
to be listed in the LISTING file, 


Useucs, 
tue Sobor command uses two separate programs to compile and 
execute SNOBOL programs The SNOBOL compiler is itself a SNOBOL 
program that translates “ SNOBOL into SPL/1, a more basic 
string~-processing language. The SPL/1 assembler-interpreter 
executes SPL/1 programs interpretively (performing the requested 
operations for the user's program, rather than translating 
nis program into machine language). ‘The compiler and assembler- 
interpreter use several files, described bclow. In eacn case, 
"filename" is the,.filename specified with the SNOBOL command. 


“filename SNOBOL Pi" is tne input to the SNOBOL compiler. It may 
consist of a SNOBOL program or program and Subroutines, a 

mixture of SNOBOL and SPL/1 programs, or entirely of SPL/1 
programs which have already been compiled. SNOBOL subroutines 
MhMust begin with a SUBROUTINE statement and end witn an END card, 
SPL/1 programs must be preceded by a ~MEMBER=: statement 

to be handled by the compiler. A -DATA card must close input 

to the compiler, whether data cards follow or not. The SNOBOL 
file may also contain the other control cards listed above. 


"filename SPL1 P1" is the output from the SNOBOL compiler, and’ 
is input to the SPL/1 assemLler-interpreter. If subroutines 
are included in the SNOBOL compiler input, each will pencrare 

a scparate SPL1 file, with tne subroutine name used as a 
filename. An SPL1 file may ve executed without compilation 

by snecifying the SPL4 option. 
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"filename LISTING P1" is a listing file created by both the 

conpiler and the assembler-interpreter. According to the 
‘options specified and the control cards included, it may contain 
any or all of the following information: 


1) <A-listing of the SNObOL source program, including 


Giaynostic messages immediately following any errors 
detected, 


2) A listing of the SPL/1 program as it was loaded for 
execution. . : 


3) Any output generated by a SNOBOL PRINT statement 
in tne program, 


4) A message explaining any error completion, 


5) Output generated by the TRACK subroutine, if tne 
3rogram reyuested it. 


“filename PUNCn PI" is created if a -DECK control card is 
encountered in the program, This file is similar to the SPL1 
file, except tnat comment cards are deleted and a special 
abbreviateu format is used. It is generally about one-tnird 
tne size of tne SPLI file for the same program, 


“filename anynanme Pi" is tne general identifier uscd for files referenced 
by name from a SNOBOL prograin. "filename" is the name of the 

program, and "“anynane" is the name used for tne file within 
the program, See Input/Output uncer “SNOLOL Programming." 


If tne compiler detects an error, a diagnostic message is 

placed im. tne LISTING file, ana a WALT instruction is inserted 

in the SPL1 file. Compilation continucs to the -DaTa card, 

put execution will Le terminatcd at the HALY instruction. 
WOLES: 

a. CS SNOLOL Gifters in some significant ways frow other 

SLOLOL implementations. Tne "SNOLOL Programming" section of 

tis manual describes briefly tne I/U subroutines of CMS 

SausOL, but does not attempt to define the language. The 

user should be familiar with the manual listed under References. 


b. SNObOL accepts any of the 256 LBCDIC bit patterns as data, 
but names anu labels are restricted to letters and numbers, 
ana several installation-dependcent special characters. 


Responses: 
‘yne SNOBOL commana gives no responses, unless the ONLINE option 


is specifiea. In this case, information normally placed in the . 
LISvING file is also typed out at the terminal. 
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References: 


CMS SNOLOL users should have a copy of CMS/360 SNOBOL USER'S 


MANUAL, by Stuart E. Madnick, available frox the IBH Cambridge 
Science: : fambr i ass Those interested in 
Scientific Center; Cambridge, Muss. ve r 
implementation of the language will also be interested in 
SPL/1: A String Processing Language, from the same source. 


a. SNOBOL SORT4 ne eae 
Yne file SORTS SNOBOL P1 is compiled into SPL/1V.— phage a 
created as SORT4 LISTING P1, and the SPL/1 program gaye 
SORT4 SPL1 P1. As soon as compilation 1s cone ac ee e ae 
assenbler-interpreter receives control to execute the prog . 


tie an = NOLIS'L) 
b. SNOBOL SOR14 (PLA ONLINE NOLIS 

i t ile SOR‘ L1 Pl, created in the 
his command executes the file SORT4 SP ; ; 
pxevious example. ONLINI: causes any output normally aaa in 
the LISTING file to be typed out. NOLIST suppresses the placing 
of the same output in the LISTING file. 


Error Messages: 


i, (00008) 


This is a general error code returned by the assembler- 
interpreter for most errors. An explanatory message 15 
found in the LISTING file. 


© 


iL. (00016) 


Where was insufficient room in core storage for an SPL1 
file during loading, or more than three levels of 
subroutine nesting were attemptcd. . 
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3.4.4.4 SNOBOL Programming 


Subroutines: 


CMS SNOBOL inclydes a subroutine feature, which may be used in two ways. 
System subroutines are provided, and are called by using the name of the 
subroutine as a SNOBOL statement. User-written subroutines are created 
and called by the SUBROUTINE, CALL, and RETURN system subroutines. 
The general foymat for using system subroutines is shown below: : 


pet re ee en ene ene ene ‘ 
f) 4 
A f 
‘ label subname (arg4,...,argN) — /(@where) a 
Da casteeed ected SD ae guacuin een enone eaonete Get aaiiene ' 

label. is an optional statement Iabel, ' 

subname is the naine of the subroutine. 

argi,....argN are string names or Htcrals passed to the 

subroutine. , 
where is an optional statement label specifying the subroutine 


statement at which execution is to begin. 
No blanks may separate the subroutine name and the left parenthesis. 
system subroutines are described below, grouped according to usage. 


. The 


Input/Output: 


PRINT (string) writes the string specified on the LISTING file. <A literal of fewer 
than 63 characters may be specified instead of a string name. 

READ (string) reads successive items from the SNOBOL input file into the string 
specified. These items followed the -DATA caad in the input stream. 


PUNCH (string) writes the string specified into 
filename is the name of the program. 
characters or less in Jength. 
also be specified. 


"filename PUNCH Pi", where 
The string specified must be 80 
A literal of feweo: than 63 characters may 


GET (string 4, string?) 
PUT (String1, strine?) 
CLOSE (string) 
EJi CT (string 1) are used to access files on disk or the user's terminal. The 
filename of the file refereuc ed is always the same as the name of the 
program being executed, "string4'’ specifics the filetype of the file 
referenced. This operaiid may also be expressed as a literal, For 
example, if TUST is a SNOBOL program being executed, and the string DATA 


. . 01- 22-68 
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contains SAMPL, cither of the following statements would read an 


item from the file VES‘ SAMPL P4: 4 
LALL GLT (DATA, NUMS) 


LAbBL GEE (* SAMPL! ,NUMS) ; : 
GLT and PUL both open files automatically, if necessary, but if 
the same file is to be written and read, a CLOSE must be issucd 
between the operations, (This does not apply to tne terminal.) 
unly eiyht files may be open-at any one time, including tne 
systen files such as the LISWVING file. : 


kbxcept for the terminal and the LISTING file, record. size is 
always 80 characters. The LISTING file has 120-cnaracter records, 
plus a carriage control character. Size of a terminal record 

is always the number of characters written or read. A literal 

of fewex than 63 characters may replace “string2" in'a PUT 
statement. 


The terminal is accessed by specifying a filetype consisting 

of blanns. This may be done in three ways: by specifying a 
stringy containing from one to eight blanks, by specifying a 
literal blank, or by omitting the first operand. The following 
tnree statements all read one record from the terminal into 

tne string IN: 


LA GL (LeKMINAL, Tin) 
GLi(' ', IN) 
GL'T (, 18) 


Yoe first assumes tnat the string ULRMINAL contains only a series 
of blanks, ‘The CMS delete characters have their usual effect, and 
wail input is translatea to upper case. A line consisting of only 
"a carriaye return causes an I/O error and program teriwination. I1f 
a whole line is deletea byQ, another read will be issued, 


a carriage-control character to be 
forcing a page eject when the file is printeca, 
buLCL(LISvilsG) forces the LISTING file to skip to the top of a 
paye. Any file for which an LJLCY is tne first statement issued 
will have a carriage-control character prefixed to eacn item as 
it is written ont, This cnaracter is returnea as tne first 
cnaracter of strings read back in from such a file 


Yne BILCT statement causes 
placea ina file, 


Susroutine Generation: 


SUELBROLYI NL (axg1],...,argii) must be tne first statement of user- 





written subroutines. An bw card must concluae the suvroutine,. 
Yoo name vy which tue subroutine will be called must he placea 
in the lavel fielu of. the SULKOUL INE statement. nis name will 
also we usca for the filename of the SPL1 file yenefrated by toe 
compiler for the subroutine. tne SULRUUTINE statement may also 
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A, 
‘include an unconditional branch. An example of a SUBROUTINE statement is: 


SORT SUBROUTINE (TRING, FIELD, NUM)  /(PROCESS) 

This statement causes the SNOBOL compiler to generate a file SORT SPLIi P4, 
which is loadcd whenever this subroutine is called by the name “SORT. On 
receiving control, execution would begin at the statement labelled PROCESS. 

If the transfer had been omitted, execution begins at the first statement of the 
subroutine. STRING, FIELD, and NUM arc the strings received as argumenis 
by the subroutine. 


RETURN (dunimy) is used te return control from a subroutine to the calling programs 
If RETURN is executed in a main program, all files are closed, and control is 
returned to the CMS Command environment. "dummy" is a dummy string name 
which must be included. 


: Linkages: 

CALL (string, argi,...,argN) is used to call a subroutine genexated by the SUBROUTINE 
statement. "string'' specifies a string containing the name of the called subroutine, 
or may be a literal specifying the callee. "‘arg4,...,argN"' are the strings passed 
to the subroutine. Their names are independent of those used in the SUBROUTINE 
statement, and matching is done positionally. A CALL statement may also include 
a statement Jahel, and an unconditional transfer specifying a return point. A-call 
to the SORT routine described above might appear as: 

ss GOSRT CALL (‘SORT', TEXT, CHAR1, LENGTH) /(SEM) 

7 The strings TEXT, CHAR1, and LENGTII are passed to the subroutine as STRING, 

FIELD, and NUM, respectively. On return, coutrol gocs to the statement labelled 

SEM, Only three levels of nested CALLs are permitted, but up to that depth, 

CALLs may be recursive. ; 

XCTL (name) overlays the currently executing SPL/4 program with the specified SPL1 
file, and starts executing the new program. ‘'naine" specifies a string containing 

- the name of the called SPL1 file, or may be a literal. No argunents may be passed. 


Debugging Aids: 


TRACE ON (dummy) 
TRACE OFT (lummy) are used to turn the TRACE option on and off. The TRACE 
option may also be enabled by the -TRACE control card. 'duinmy'' is a dummy 
string name Which must be present. When the TRACE option is in effect, the 
contents of cach string are placed in the LISTING file cach time it is referenced. 
= The assembler-interpreter location counter value is included with cach string. 
: The counter value refers to statement numbers in the assemblcr-interpreter s 
: listing obtained when the -ASSEMBLY ON control card is used. 


Tuibl 
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TIME (name) returns the current timer value in hundxeths of a sccond in the string 
specified. Under CP, the timer value is clapsed virtual CPU time since LOGON. 
It is useful for comparative timings of programs. 


. 





E2S25 


ae ee 


Usage 


Sespo 
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The ERUIN command initiates the Frewn Qniversity Interpreter. 


- ss ew 


BRUIN 
Bo 


The ERUIN €nvirenment is entered. ‘then the character > (greater 
than) ig printed and the keyboard unlocks, the interpreter is 
ready to accept a ccmmand. A BRUIN command should then be entered 
impediately following the > character. 


To leave EFUIN and return to the CMS comrand environment, issue 
the BRUIN command 
, CANCEL 


+ 


ERUIN vas developed at Brown University, 
Ercvidence, Rhode Island. Fer information on BRUIN 
and its ccmmands, refer to the document BRUIN 
(Exrcun University Interpreter) for the Cambridge 
Fonitor System (CMS). 


13es: 


ERUIN : 
As the result of a null line being entered, the interpreter 
is confirming that the user is in the BRUIN environment. 


BRUIN REALY 
The FRUIN envircnment has teen entered and it is ready 
to accept commands. 


Ry T=xxe xx 


The CHS coemand environment has been entered, vhere the 


X¥xXeKK is the cPu time used in seccnds. 


Fer'cther tespcnses, 


FEEge_n 


€ssagest 


None. 


refer to the references above. 
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3.5.0 Miscellaneous 


The miscellaneous commands in CMS include ECHO, which 

is used to test terminal transmission; EXEC, which 
executes a sequence of CMS commands from a disk file; 
FORMAT, which initializes a user's file space; and 

KO, KT, and KX, which clears overrides, kills typing, 
and terminates execution, respectively. LOGIN either 
saves or deletes a user's files. LOGOUT compacts 

the user's file directory and logs the user out of CMS. 
STAT provides statistics on the user's file space, 
MAPPRT creates a load map of the CMS nucleus, and IPL 
reloads a copy of the CMS nucleus.  DIVERTSW diverts 
output from Fortran and PL/I programs directly to the 
offline printer. TIMELIM sets a time limit for the 
execution of a particular CMS command. GETLIB allows 
the user to access files on a library disk. QUICK 
provides the capability of doing operations ina 

file without continually referencing the file identifier. 
DOSBATCH transfers files to the VCS DOS BATCH machine. | 
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3.5.0 Miscallaneous 






The miscellaneous commands\in CMS include ECHO, which 
is used to test terminal trdpamission; EXEC, which ' 
executea a sayuenée of CMS edymands from a disk fila; 

FORMAT, which initializes a user's file space; and 

KO, KT, and KX, which clears ovarrides, kills typing, 

and terminates execution, respeckively. LOGIN either 

Saves or deletes a user's files. OGOUT compacts 

the user's file directory and logs \the user out of CMS, 

STAT provides statistics on the usex\'s file space, 

MAPPRT creates a load map of the CNS! nucleus, and IPL 
reloads a copy of the CMS nucleus. DIVERTSW diverts 

output from Portran and PL/I programs directly to the 

offline printer, QINELIM sets a time limit for the 
execution of a particular CiiS comand. GETLIB allows 

the user to access files on a library disk. 
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The LINEKD command defines tha logical line-end character to be 
used in adéiticn tc the carriage return (new line). | 


Fermat: 


-— = eee me 


! t 
} LINEND | 
| | | 


~_=-— -— 


c is the redefined logical line-end 
cheracter. If c is net specified 
there is no jine-end character defined 
ané the carriage return is the only 
line delimiter. 


Usage: 


The logical line-end character permits a number cf logical 

input lines te be typed cn a single physical input line separated 
by the line-end character. The physical input line is terrinated 
ty a carriage return. Legical input lines are terminated hy the 
line-end character or ky the carriage return. Each call to read 

a line fren the terminal will return the lcegical input line. 
Subseyguent calls to read a line from the terminal will return the 
logical ingut line which was given fcllewing the previous Logical 
input line. The line-end character can ke used to input logical 
lines whenever a fhysical line ie input from the typewriter whether 
to CMS or to a program. In addition, logical lines can be input and 
stacked Fy use of attention to CMS (double attention if from CHS 
and running under CE). fkefer to section 2.2.3. . 


1. The defined line-end character is the #@ unless the LINEND 
comman¢é has been issued to redefine the character. 


2. dif the command LINEND is issued without any parameters, 
enly the carriage return will be used as the line delimiter.. 


3. When a physical input line is read, it is scanned and 
processed according ta the specificaticns in BAITRD. 
lower case to upper case conversion is specified, the 


If 


i OS/f/ul,y 2 
YR. 3.5.1-2 
complete physical input line will be translated... Thus 32.7 aor ’ hee op 
all lccical input lines are translated according to the “/7/ ; , . ECHO 23 
initial specification. 





3.5.2 ECHO 
4. The redefined line-end character stays in effect until Purpase: 
either CNS is iPled again cr LINEND ig reissved. ate eess: 
The ECHO command tests terminal transmission by retyping — 
entered lines. 


Format; 
1. LINEKE ? Vr ee; 
The line-end character is set to the exclamation mark (!) 


; ; ECHO 
2. LINEXE EC 


—— a | 
' t 
’ 1 
‘ t 
cI} 
' fo) t 
' oo? 1 
1 Hs 1 
, 8 4 
t a t 
| Ss a 
t ' 
t t 
t ' 
' ' 
oe ee at 


There is ne lenger a defined line-end character, bodeeocc owe loses 
therefore, only the carriage return will be used : 
as a line delimiter. option one of the three ECHO options, or if not specified, 
the default option U is assumed, 
Firgi_Nessages: ‘ 
Options; 
None. . Us‘ The delete characters (¢, @) are interpreted, and any lower- 


id 
case lettcrs are changed to upper-case, 


S Delete characters are interpreted but no lower-case to upper- 
case translation is madc. 


X No change is made in the line. 


s 


‘ 2 . ; Usage: 


er : ; When the. ECHO conimand is issued, the Echo environment will be 
entered and cach line typed by the user is repeated by the terminal. 


If no option, or an invalid option, is specified, Uis assumed, An 
entercd line is interpreted according to the option specified, if any, 
and then typed out. The keyboard is then unlocked to accept another 
line, 


Control is returned to the CMS command environment by typing 
\ RETURN as the first word of a line with no leading blanks. 


Notes: , : 


a. If the X option is in effect, RETURN must be entered without error 
to be recognized (delete characters are not interpreted), 


b, The Ready message following the RETURN request indicates that the 
user has left the Echo environment and entered the CMS command 
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ECHO af 
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Responses: 


START TERMINAL TEST 


The first line may be entered when the ewpente unlocks after thie - 
message is typed. 


Examples: 

a. echo u 
START CONSOLE TEST 
echo retypes any entered lines, 
FCHO RETYPES ANY ENTERED LINES, 
return. 
RETURN | 
Re T=0,03- 


b. echo s 
START CONSOLE TEST 
inceé Including Nelettonss@, Backspaces, & special characters, 
Including Deletions, Backspaces, & special characters, 
Return. 
Return: 
PR; T=0,03 


ec echo x). 
START CONSOLE TFST 
Except. In the X modeé 
Except In the X modeé 
returrgn 
returrQ@n 
return 
return 
R; T=0.03 


Frror Messages: 


None. 


hag 
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3.5.3 EXEC 38 Hey 
Contents: 3.5.3.1 Basic Usage of EXEC 
3.5.3.2 Special Features of EXEC 
3.5.3.3 EXEC Control Words 
3.5.3.4 Operating under EXEC 
3.5.3.1 Basic Usage . 


Purpose: 


EXEC executes one oy more CMS commands contained in a specified file, 


allowing a scquence of con:imands to be executed by issuing a single command, 


Format: 


ee ae ce i eae epee gin Ah fey Gee ay ee WERE Roe ge Oe ee Te eae gon a ee ge giegee ak Te. 
t EXC ' filename ‘s argl,..ay gN7] ‘ 
filename specifies the filename of a file containing one or more 
CMS commands to be executed. The filetype must be 
EXEC, 
argl...argN arc the arguments to replace the numeric variables in 
the file "filename EXEC," 


Usage: 


EXEC executes the.sequence of commands that are specified by EXEC lines |. 
contained in the file "iilename EXEC", This file must be in card image form 


and must consist of one CMS command per card image in the same format as the 


command is entered at the terminal. The filetype for the specified file must 
be EXEC, EXEC files can be created by the EDIT or LISTF commands or by 
a user's program. 


Each CMS command in the EXEC file can have from one to thirty numeric 
variables. A numeric variable is rade up of an ampersand (&) followed by an 
inteper ranging from one to thirty, i.e., &1&2..,.&30. Before the command 


is executed, each variable will be temporarily replaced by an argument specified 


when the EXEC cornmand was issued. For example, each time an &l appears 


as a variable in an FXINC line, the first argument specified with the EXEC com- 


mand will temporarily replace the &l, the second argument specified with the 


EXEC command will replace &@ and so on to argument N of the EXEC command. 


If the double quotation mark (") is used in place of an argument, the corres- 
ponding variable (&N) will be ignored in all the commands which reference that 
variable. If the specified EXC file contains more variables than arguments 
piven with the RXEC command, the higher numbered variables are assumed to 
be missing and will be ignored when the commands are exccuted. 


Responses: 


. 
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Arguments can be concatenated to the right-hand side of any word in 
an EXEC line. For example, the EXEC line LISTF ABC&)] FORTRAN&2 
would result in LISTF ABCXYZ FORTRAN if argl is XYZ and.,arg2 is 
unspecified. Use of the double quote (") for argl would cause the variable 


_to be ignored leaving LISTF ABC FORTRAN. If the single quotation - 


mark (') is useu in place of an argument, the entire concatenated form 
will be deleted. For example, in the above EXEC line if argl is specified 
with a double quote ("') and arg2 is specified with a single quote (') the 
line would be just LISTF ABC. ae on 

The EXEC command is completely recursive, i.e,, an EXEC file can 
contain other EXEC commands in its sequence of commands. The re- 
cursiveness is limited by core size--each level of recursion requiring 
about 1200 bytes of free storage for data. This limits the depth of 
recursion to approximately 16. : 


Notes: 


1. Errors resulting from issued commands are not fatal and do not 
cause the sequence of commands to be terminated. This behavior 
may be modified by the EXEC control word &ERROR (sce 3.5.3. 3). 


2, Each EXEC file may contain a maximum of 4095 EXEC lines. 


3. This version of the EXEC command is completely compatible with 
EXEC files created for use with the previous version of EXEC command 
except that in this version only one command is allowed per line, 


This compatibility may be removed in‘a later version to save spacé 
in the CMS nucleus. 


. 
‘ 


As each CMS command in the EXEC file is issued, it is typed at the terminal. 


Error Messages: 


E(00001)FILE DOES NOT EXIST : 
: The EXEC file does not exist. The EXEC command has terminated, 
Check to see if the filename specified has a filetype of EXEC, 


E(00003)FILE HAS WRONG RECORD SIZE 


The specified EXEC file does not contain 80 character records. The 
command is terminated. , 


F(00006)WAITRD OR RDBUF ERR : 


This error would result if an EXEC file was erased after the EXEC 
command had been successfully begun, ; 
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EXEC 7742 
For example, with the procedure shown in Figure 3.5.3-A, the file 


ABCD EXEC would be erased, and the attempt to read the EXEC line : excc fortclg llhs 
containing PRINTF would result in the error, The EXEC command is FORTRAN LLHS 
terminated. LOAD LLHS (XEQ) 
: EXECUTION BEGINS, sf ae 
printf abcd exec APRIL 1968 DATA 5.320 1,929 5. 600 
ERASE ABCD EXEC T=0.55/1.44 01. 30.45 


PRINTF XYZ&2 
T=0.02/0.13 03.45.14 


FIGURE 3.5.3-B Example of an EXEC file 


. , to compile, load, and 
ie es EXEC execute a FORTRAN 
WAITRD OR RDBUF ERR a al 
E(00006) T=0. 05/0. 08 03. 46.10 : 
edit fort exec - ’ 
Figure 3.5.3-A - INPUT: 
; fortran &] (print) 
VIVE (xxxxx)!!! . 
The error code xxxxx was generated by the CMS command issued EDIT: » 
from the EXEC file. Chéck the appropriate command in the appendix file 
for this error message. T=0.55/1, 43 01.30. 50 
Examples: 
oe printf list{ exec , 
a. In FIGURE 3.5.3-B the command EXEC FORTCLG LLUS is issued. ‘ LLHS &l &2 W FORTRAN P5 001. 
is a file whose filetype is FORTRAN and LLHS will replace the &1 in all &l &2 SUB2 FORTRAN | PS5 001 
GMS commands in the EXEC file. The file LLHS FORTRAN is compiled, &l &2 A FORTRAN P5 001 
and the file LLHS TEXT is loaded and executed. Note that each CMS &1l &2 SUBB FORTRAN P5 a 
command is typed out before it is executed. , T=0, 55/3.21 01.32.15 
b. In FIGURE 3.5,3-C the FORT EXEC is created by EDIT. The only com- ; 7 c 
mand placed in the file is "FORTRAN&IU(PRINT)", The file LISTF EXEC excc listf exec fort 7 ‘ P5 001 
is then typed out by issuing the PRINTF command, The EXEC command is —~s EXhG “FORT W , FORTRAN : 
then issued specifying the filename LISTF and the two arguments EXEC and FORTRAN W {PRINT) 001 
FORT, The file LISTF EXEC was created earlier with the LISTF command EXEC - FORT SUB2 FORTRAN - PS 
(see Section 3.1.9) and contains the sequence of FORTRAN files to be com- FORTRAN SUB2 (PRINT) : 5 001 
. Pilead. Each file identifier in LISTF EXEC is preceded by two symbolic EXEC FORT A FORTRAN P 
arguments, &l and &2, The &lis replaced by the first argument specificd FORTRAN A (PRINT) Z 001 
with the EXEC command which is EXEC and the &2 is replaced by the EXEC FORT SUBB FORTRAN P 
sccond argument specified which is FORT, The sequence of CMS commands FORTRAN SUBB (PRINT) 
eenerated in core by EXEC from the file LISTF EXEC are then executcd, | , T=1,.50/1, 80 01. 33. 27 
the first‘of which is peat 
EXEG FORT W FORTRAN P5_ 001. FIGURE 3,5.3-C The file FORT EXEC = aia 
This command executes the sequence of commands in the file FORT EXEG created, the file LIST 7 
and temporarily replaces the numeric variable &l from FORT EXEC with is typed out, gang then mar 
the argument W. The arguments FORTRAN, P5, and 001 are ignored 3 EXEC command pe eer 
because there are no variables &2, &3, and &4 for them to replace.. As , to nest EXEC's. 


£00n as the sequence of commands in FORT EXEC are completed, the 
next command in the file LISTF EXEC is executed. This sequence ; . 
continues until all commands are executed in the LISTF EXEC file. F . 
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A line ‘of an EXEC file specifies cither a CMS command or is an EXEC control 
line. EXEC control lines control the sequence of commands to be executed, 


specify what is to be typed on the console during the execution of the EXEC 1. 
command, or provide input to other command programs or to the EXEC 
command itself, 8 2: 


EXEC lines, containing cither a CMS command or an EXEC control, may be 
identified with a label. If the first word of an EXEC line begins with a dash (-) 
it is assumed to be a label of an EXEC line. Labels are used in the control 

of the sequence of MXEC lines to be executed (see 3.5.3.3 - &GOTO and &LOOP). 


EXEC lines may contain words which begin with an ampersand(&). | A word 

beginning with an ampersand may be either a) a numeric variable, b) a keyword, 

i,e., a symbolic vuriable, or ¢) a control word. A numeric variable consists 

of an ampersand followed by an integer or an asterisk(*), A keyword word 3, 
consists of an ampcersand followed by a string of not more than 7 characters at 

least one of which is not an integer. Control words have the same form as key~ 

words and are defined in section 3.5.3.3, Numeric variables and keywords are 4. 
substituted for before the EXC line is interpreted, 


Numeric variables are substituted for by arguments which are specified when the 5. 
EXEC comrnand is issued (sec 3.5.3.1), The numeric variable &0 is replaced by 

the filename of the current WKEC file, The nurneric variable &n is ignored when 

nis negative or preater than 30, or njs greater than the number of arguinents 

supplicd when the XE C command is issued. The variable &* is interpreted 6. 
to mean al) arguments specified, When the variable &* is included in a CMS 

command, the cominand is executed once for each argument specified. For 

example, the command line PRASHE &* * would cause the crasing of all files 

whose filename is the same as one of the specified arguments, The Variable 

&* may also be used in an &IF or &LOOP condition (see 3.5.3.3). 


The valuc. substituted for a keyword may be 
i) specified in an EXEC line, or 
ii) implied if the keyword is a special keyword. 
The value of a keyword may be specified by an EXEC line of the form:. 
, &KEYWORD = VALUE 
which defines the keyword &KEYWORD to have the value VALUE. 


Keywords can be redefined as oftenas desired, 
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A number of keywords have been defined to have special meaning and 
. have their values set in a special way. 


&LINENUM - has the value of the current EXEC line number plus one. 


&INDEX1,., &INDEX9 - are used as irdices and initially have the 
value +1, Indices 1 through 9 may be reset or incremented by an 
EXEC line. These indices may be set to an integer value in the 
same way as the value of any keyword is sct, An index may be 
incremented or decremented by specifying the index and the 
increment in an EXEC linc. For example, 

&INDEXS = 30975 will set RINDEXS5 to 30975. 

&INDEX? - 50 will add -50 to the value of &RINDIX7. 
Indices are local to the current level of recursion, — 


&INDEX0 - has as its value the code number in register 15 on return 
from the previous CMS command. 


& INDEX - has as its value the number of arguments given when the 
EXEC command was issued. 


&GLOBALO,..&GLOBALY ~ are used for communication between 


’ levels of EXEC recursion and are set and incremented in the same 


way as &INDEX),.. &INDEEXY, 


& GLOBAL - has as its value the level of recursion. 
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3.5.3.3 EXEC Control Words (— BG re 
The following EXEC control words can be used to provide a versatile and 
flexible facility for controlling the execution of commands and for de- 
fining a user oriented command environment. EXEC control words appear 


in EXEC lines which can be interspersed with CMS commands in an EXEC 
file. = 


& CONTINUE 





1) &ERROR [ action 


Action is any excc line without a statement label. Action will be 

executed immediately upon an error return from a subsequent CMS 

command. If action is not given, &CONTINUE (see below) is 

assumed. An crror in execution of action, if action is a CMS 

command, will result in an exit from this level of EXEC with crror 

code of ll, : 


2) &IF condition action - ; - 5) 


where condition consists of the three parameters: 


a. 
&$ 


anything anything 





and action is any EXEC line without a label. If the condition is 
satisfied, the action is executed. The comparison specified by the 
second argurnent is made between the first and third arguments. 
The &$ is interpreted as "any of the symbolic arguments." Thus, 
the EXEC line: &JF &$ EQ XYZ &PRINT HI would cause "HI"' to 
be typed if at least one of the arguments specified when the EXEC 
command was issued was XYZ, Similarly &* is interpreted as 
"all of the supplied arguments". (See below for a description of 
&PRINT. ) 


’ A numerical comparison will be made only if both the comparands 
are numerical. For example, the EXEC line: &IF 017 EQ 17 &PRINT . 
HI would cause the typing of "HI". Otherwise, the comparison in a 7) 
condition is a logical comparison. 
n 
3) &EXIT [>| 


An‘exit from EXEC is taken with an crror code of n. If nis not 
given, a normal exit with a code of 0 results. If n is negative and 

if EXEC was called from the CMS command level the absolute value 
of Nis returned. Hf this EXEC command was called from a previous 
EXEC command a negative valuc of n will be returned as the error 
code in register 15. 
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EXEC YY, 
&QUIT = | Kae 
, ON 
OFF 


&QUIT n is similar to &REXIT n except that QUIT n will return to 
level 0, the CMS command level, regerdless of the level of re- 
cursion of EXEC commands; whereas, &EXIT exits to the next 
lower level of recursion. 


&QUIT ON sets the return level for a subsequent &QUIT control 
to one level highcr of recursion. Thus, if &RQUIT ON is issucd 
twice and if the current Jevel of recursion is 5, an &QUIT n would 
cause a return to level 2 with an error code of n. 


&QUIT OFF will resect the return level to level 0, the CMS 
cominand level. 


&SKIP i 
: yn 


If n“0, the next FXEC line to be executed will be n lines before the 
current line. If n>0, the next EXEC line to be executed will be 
ntl] lines after the current line, i.c., n lines are skipped. 


& GOTO TOP 
label 
EXIT 


&GOTO TOP will cause sequential execution of EXEC lines to be 
continued at the beginning of the EXEC file. 


&GOTO !XIT is identical to,&EXIT 0 and causes a return from the 
current level of EXEC command. 


&GOTO Jabel will search the EXEC file starting from the present 
EXEC line and proceeding to the end of the file, then to the beginning 
of the file, and finally back to the present line location, looking for 
the first EXEC line beginning with the specified label. 


. label condition 
& LOOP nl n2 


This EXEC control] line causes looping either 1) to and including the 
labeled linc, or 2) through the number of lines specified by nl, be- — 
ginning with the next line. Looping continucs cither 1) until the condi- 
tion is satisfied, or 2) for n2 times. The condition is specified the 
same as with the &IF control word and is first tested before looping. 
Loops may be nested to a depth of 4. 


The numbers nl and n2 must be less than 4096. 








8) 


9) 


10) 


Nl) 


12) 


This EXEC line is ignored. 
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SHR 


It may be useful with &GOTO or & LOOP and 
is the default action for KERROR, 


& CONTINUE 


&TYPEOUT ALL TIME PACK 
ON NOTIME NOPACK 
ERROR : oo 
OFF 


NOEXEC 
ALL causes all CMS command lines and EXEC control lines to be typed. 


ON causes all! CMS command lines to be typed but suppresses the typing 
of EXEC control lines. 


ERROR causes only the CMS command lines which result in an error to 
be typed. EXEC control lines are not typed. 


OFF suppresses the typing of all FXEC lines. 


NOEXEC is the same as OFF and is permitted for compatability with EXEC 
files created for.use with the previous version of the EXEC command. 


TIME causes the time of day to be typed preceding each CMS command 
line typed. 


NOTIME suppresses the typing of the time of day with each CMS command 
line, 


PACK causes excess blanks to be removed from a line ta be iyeea EeRUPHnE: 
in only one space between words in an EXEC line. 


NOPACK suppresses the Séuioval of excess blanks from a line to be typed. 
& TIME type 
ON 


Or} 
{-——- 





-& TIME will cause typing of the time since the last time the time was typed. 


&TIME ON will cause typing of the time message after each CMS command 
is typed, 


& TIME OFF suppresses the typing of the time after cach CMS command, 
&SPACE (i | 


n 


This control word causes n carriage returns to be typed at the console. 
& PRINT line : 5 


"Line" will be printed on the typewriter console, 


All keywords, symbolic 
arguments, etc.,, will be substituted into‘the Hne, ; 


13) 


15) 


16) 


17) 


& READ 1 
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&COMMENT line fYO 


‘This EXEC line is ignored and can be used to annotate the EXEC file, 


& ARGS argl,....argN 2 
The parameters argn are used to redefine the numeric variables &n and 
the special keyword &INDEX is redefined to have the value of n, 


— 


n 

ARGS 
If nis specified, the next n EXEC lines will be read from the typewriter 
console instead of from the EXEC file. As each line is read it is 
executed as if it were read from the EXEC file. 


If n is<0,reading will stop and the next EXEC line will be obtained from 
the EXEC file. Reading is also terminated by typing &GOTO, &SKIP, 
&LOOP, &EXIT, or &QUIT or can be reset by typing apoE &READ — 
control line. 


If ARGS is specified, one line will be read from the console, the line 

will be scanned and used to redefine the numeric variables ‘The special 
keyword &INDEX will be redefined to be the number of ar guments read. 
The line read will not be executed as an EXEC line. 


Only the first 72 characters on a line will be read. 


&STACK FIFO line 
LIFO 


All numeric variables and keywords in a line are substituted for, and the 
line is "stacked" in the input buffer. Subsequent calls to read from the 
console will obtain lines which were stacked in the input buffer. 


If the first word after the control word is FIFO the line is stacked ina 
First In First Out order, If the first word after the control word is LIFO 
the line is stacked in a Last In First Out order. If not specified, FIFO is 


assumed, 
&BEGSTACK FIFO 
LIro 





line l 
line 2 
line N 
& END STACK 


ra 
a 


This sequence will stack lines line 1 through lineN, literally without trunc- 
ation and will not substitute for numeri¢ variables or keywords. This se- 
quence may be used to specify input or EDIT request to the EDIT cornmiand. 


Notes: 


1) 





2) 


3) 


4) 


5) 


Errors: 
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This control word has been defined for compatibility with old EXEC files 
which used the control words FRR and TYPFOUT or actions. &5lT may 
later be removed as an EXEC control word. 


All numeric variables, keywords, EXEC control settings, and limitations 
(c.g., max. depth of loop nesting) are local to the current level of EXEC 


-unless otherwise noted, : 


Any EXEC control word may be abbreviated by a sufficient number of 
characters to distinguish the control word from other control words, 

The following precedence order is observed: ERROR, ExXIY; SKIP, SPACE; 
STACK, SET; IYPEOUT, TIME 3 of.er control words, followed by other 
keywords. Keywords cannot be abbreviated. 


An crror from a CMS command does not cause an exit from the level of 
EXEC, 


- When EXEC is entered, the assumed state of the controls are 


&RERROR, 2CONTINUE, &TIME OFF, and &TYPEOUT ON TIME PACK, 


If an EXEC line specifics an invalid CMS command, an error code of 
E(-0007) will be returned. The EXEC command is not terminated. 


E(00001) File docs not exist. 


F(00002) &SKIP or &GOTO error. 


£(00003) > Files has wrong record size, 

(00004) Keyword or argument error, 

F:(00005) Exceeded maximum dépth of loop nesting. 

¥£(00005) Waitrd or Rdbuf crror. 

EF (00008) legal form of condition. 

F(00010) Error in &GLOBAL or &INDEX usage. 

F (00011) Error occurred in attempt to execute BERROR's action. 
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3.5.4 FORMAT 


Purpose: 


The FORMA‘E command is used to initialize a disk area in the CMS format, or to 
count the number of cylindtrs ona disk, 


Format: 
Cf AG) ee ' 
t FORMAT (JP ALL|] 3 
‘ FORM : T C ' 
iacuceeele ae peeked Cee H 
P specifies that the user's permanent disk area is to be 
initialized, and any files on it erased. 
T specifics that the user's temporary disk arca is to be 
initialized, and any files on it erased. 
ALL © specifies that all tracks of the specified disk arca are 
to be initialized. If omitted, the first three records of 
-Cylinder 0, Track 0 are skipped. ; 
Cc specifies that the command is a check only, and cylinders 
are to be counted, but not erased. 
Usage: : 


P or T must be specified. According to the option selected, the user's permanent 
or temporary disk area is initialized by writing a new home address and four 
records on each track. Any previous data on the disk is crased. 


Uniess ALL is specified, the first three records of Cylinder 0, Track 0 are 
skipped. The ALL operand should be specified in the FORMAT command 
whenever an unformatted disk arca is accessed for the first time, and will 
not normally be needed thereafter. 


If C is specified, data on the disk is not evrased, and any files are preserved. 


Response: 


x-DISK: nin CYL, 
The number of cylinders formatted is typed out, indicating which disk was 
initialized, If C was specified, this number of cylinders was counted, but not 
crascd. ; . : 





* 
. 
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format p 

P-DISK; 010 CYL, 
The permancnt disk is initialized by writing home addresses and four blank CMS 
records on every track. Any files are destroyed. The response indicates the 
user's permanent disk under CP consists of ten cylinders. 


. Error Mcssapes: 


F (00001) PLEASE SPECIFY DISK: PERMANENT (P) OR FEMEORARY (T). 


‘ The first parameter specified was not P or T. 
E0002) CONDITION- CODE 1 ON SIO IN FORMATTING DISK: (BAD) 


‘The condition code after Start I/O was issued indicates the 
operation was not accepted, Notify the operator. 


FE (00002) CONDITION-CODE 2 ON SIO IN FORMATTING DISK (BAD) 
, Vhe condition code alter Start I/O was issued indicates the 
‘channel was busy. This should not occur undex CP. Notify 

the system operator, 


| £00002) CONDITION- CODE. 3 ON S10 IN FORMATTING DISK (BAD) 
The condition code after Staxt 1/0 was issued indicates the 
‘device addxussed is not operational. Notify the operator. | 


(00003) UNEXPECTED UNIL-CIIECK IN FORMATTING DISK 
A unit check occurred. Notify the operator. 


£ (00004) ‘CE and DI; NOT FOUND ‘TOGETHER (VERY STRANGE) 
: Channel cud and device end did not occur correctly. Notify 
‘the operator, 


(00005) Same as I! (00002), except C was specified with the command, 
E (00006) ‘CE and DE. NOT TOGETHER CHECKING NO, CYLINDERS 


Same as £00001), except C was specified with the command. 


E (00007) ‘UNEXPECTED UNYT-CHECK NO, CYLINDERS 
‘Same as E(00003), except C was specified with the command. 





3.5.5 KE 


Error Messages: 
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Purpose: 


Format: 


The KE command causes termina! output lines to be truncated to 80 charactezs. 
ae : 
1 KE oe 7 
i] ‘ 
tame n ry 


Usage: 


The KE command is used to truncate terminal output from an executing CMS | 
command or user program. In order for the KE command to be recognized, 

it must be entercd after interrupting program execution by hitting the attention 
key once to transfer to the CP environment and a second time to transfer control 
to CMS, Typing KE at this point will cause termina) output to be truncated to 80 
characters until the command or program completes. Data beyond 80 characters 
is lost. Normal terminal output will resume after the executing program hi 1s 
been completed. 


a. Entering KE as a normal CMS command will have no effect. KE has mcaning 
only after two attention interrupts have been generated during program executicn. 


b. If the keyboard does not unlock following the second attention interrupt, | 
internal processing is probably taking place which docs first allow interrupts 
from the multiplexor channel. As soon as this processing is completed, the 
keyboard will be unlocked and KE may be entered. 


c. The character-delcte Syinibol (@) and line-delete symbol (¢) are ‘hot ‘valid 


when issuing a Kii command. : 
4 


Example: 


a. KE 


‘Assuming that the attention key had been hit twice prior to typing KE, CMS 


would intercept and truncate to 80 characters any terminal output from the 
command or program in progress, 


None. 


01-22-68 
3.5.6-4 
Ko VG 


3.5.6 KO 


Purpose: 


The KO command may be issued during the exccution of a command or user 
program to stop the recording of trace information. 


Format: 


ene ew we 


ed 


Usage: 


The KO command causes recording of trace information, initiated by the SETOVER or 
SETERR commands, to be halted. KO differs from the CLROVER command in 

that it may be used to clear overrides during the execution of a program. In order 
fox the KO command to be recognized, it must he entered after interrupting pro- 
gram execution by hitting the attention key once to trausfer to the CP environment 

and a sccond tine to transfer contro] to CMS, Typing KO will then cause all 
overrides to be cleared, and no further trace information will be recoxded. Program 
execution will continue to its normal completion, and all recorded trace information 
wiJl be printed on the offline printer. : 


Notes: 


a. Entering KO as a normal CMS command will have no effect. KO has meaning 
only after two attention interrupts have been generated during program execution. 
b. If the keyboard docs not unlock following the second attention interrupt, 
internal processing is probably taking place which does not allow interrupts from 
the inultiploxor channel. As goon as this processing is completed, the keyboard 
will be unlocked and KO maybe entered. 


ce. The character-delete symbol (@) and line-delete symbol (¢) are not valid when 
issuing the KO command. 


d. Issuing the KO command will have no effect unless a SETERR or SETOVER 
command has been issued previously. 


Example: 


a. KO 

Assuning that the attention key had been hit twice prior to typing KO, CMS will 
stop recording trace information and at the completion of the currently cxecuting 
program, aJl recorded trace information would be recorded on the offline printer. 


Error Messages: 


None. 


01-22-68 
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TY 
3.5.7 KT 
Purpose: 


The KT command causes all terminal output generated by the CMS command or 
user program in progress to be suppressed. 


Format: 
amaeataa: ' 
+ KT 4 
LES TA 1 
Usage: 


The KT cominand is used to stop terminal typeout from an executing CMS 
command or user program. In order to enter the KT command meaningfully, 
the attention key must be hit once to interrupt execution and transfcx control to 
the CP environment and then a second time to transfer control to CMS. Program 
execution will continue but the keyboard will be unlocked to accept. user input. 
Typing KT at this point will cause all further terminal output from the executing 
command or user program to be intercepted and suppressed. Execution will] 
continue to normal program camplction, when the Ready message will be 

typed out and normal terminal output will resume. — 


Notes: 


a. Entering KT as a normal CMS command will have no effect. KT will have 
meaning only aftex two attention interrupts have been gencrated during program 
exccution. 

b. If the keyboard docs not unlock following the second attention interrupt, internal 
processing is.probably taking place which does not allow interrupts from the multi- 
plexor channel. As soon ag this processing is completed, the keyboard will be 
unlocked and KT may be centered. 


c. The character-delete symbol (@) and line-delcte symbol (¢) are not valid when 
issuing a KT command, 
Example: 


a. KT ‘ 
Assuming that the attention key had been hit twice prior to typing KT, CMS would 
intercept and suppress any terminal output generated by the program in proyress. 


Error Messages: 
None. 





05/6 ‘69 o5/0° 769 


3.5,.8-1 365.0 -2 
3.6&2E€ KX : GEE re-JBled. The CMS cconnanéd envircnosent ie then entered. HSL 
7 | 
PULECES: Error. Messages: 


The KX ccaomand causes the executicn of any CMS command or user 
Erogram'tce stcE, closes any cyen files and 1/0 devices, re-IFPL's 
CES, and returns the user tc the CMS ccanand envirengent. ; 


’ Fermats 


1 KX i 


ee 


Qsages 


In crdec for the KX ccsrand to ke recognized, it must be issued 
after interrupting preegram €xecuticn Ey kitting the attenticn key 
epee tec transfer to the CE environment and a seccnd time to 
transfer contre] te CES. Issuing the KX command will then clcse 
any cren user files and sicnal CP that the vser has ne acre Ivo 
fer cf£fling devices. After updating the user's file directory, aa 
KX re-IFL's CNS from the sane device as it was initially. IPLed, 
ang the user is returred tc the CHS commend environment. , 


. 


SS 


ot 


a. Entering KX as a nornal CMS command will have no effect. KX oy 
has peaning cnly after tc attenticn interrupts have been 
generated during pregrtam execttion. 


bE. ‘If the keykoaréd dces not unlcck f£cllowing the second 
attenticn interrupt, internal processing is prebably taking place 
which goes nct allcw interrtpts from the multiplexor channel. As 
scon as this processing is cempleted the keyboard 4i11 be 
utlcckéd and KX say be entered. : 


ce The character-delete syobtcl (a) ané line-delete synrkol (¢) 
are not valid when issuing a KX ccmmand. 


RESEOnse: | é 


CHS Version xx. KYL XK/XX 
This respense is typed shenever KX is interpreted, as CHS is 


¢ 4-01-68 
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pet Yes a Loon /5f +) 


Error Mes sages 


E(00001) LOGIN UFD FAILED | 
The user's file directory has not been successfully 


3.5.9 LOGIN 


Purpose: brought into core. If the command fails a second 
: i i h O UFD command, 
LOGIN causes the user's files to be either saved or deleted, as Dene sree ENC 
specified. E(00002) LOGIN NO UFD FAILED; TRY FORMAT P 
eres: The LOGIN NO UFD command has not been executed 
Format: correctly. Issue the FORMAT P command. 
pee ge age es ee Ol ' ' O UFD! 
E(00003) PLEASE 'LOGIN UFD! OR 'LOGIN N 
7 Teel t ; Noo D : . An invalid operand was specified with the LOGIN 
: i NO 1 ; -command. Reissue the LOGIN command in its 
Mem eee ee TE ne correct format. 
UFD indicates that the user's file directory 
: (and hence all existing disk files) are 
to be saved, 
NO UFD indicates that the user's file directory 
~ is not to be saved, effectively clearing 
( his disk area and all files stored on it. 
Usage: 


The LOGIN command, if used, should be issued immediately 

after the CMS Command environment has been entered in 

response to an IPL command, console function, or request. 

LOGIN must have an operand, which is either UFD of NO_UFD., . 
If UFD is specified, the user's file directory, and hence all of ° 
his disk files, will be maintained as they presently exist. If 
NO_UFD is specified, the user file directory will be cleared . 
and all disk files will, in effect, be erased. If the LOGIN 

command is not issued when the user first enters the CMS 

Command environment, LOGIN UFD will be assumed and all 

existing disk files will be saved. 


Examples: 


a. LOGIN UFD ; 
The present user file directory will be maintained as it currently 
exists and a compacting routine will be called to eliminate any 
blank entries caused by files which were erased during the last 
terminal session. 


b. LOGIN NO UFD 
The user's file directory will be cleared, in effect erasing all of 2 
i his files currently stored on disk, : : : ‘) 





s i 
: 05/01 
| | ; 3.5.10-1 
3.6.10 =1cGcul i MG 


: bss 


Eurrcse: i 


fhe LOGGUT ccmmand ccmpacts the user's file directory, executes 
any CMS ccmmand specified as an operand, and logs cut of CNS, 
transferrirg ccntrcel tc the CP environment. 


. Fergat: 


| 1cGCvT | Kanyccr> ! . 
i LCG { } 
anycon is any C¥S command . 
£33g9€: 


The LOGOUT ccrmand is net required shen use cf CMS has been 
completed. If issued, however, it will cause a compactirg routine 
(identical ta that which is called when the STAT C command is 
issued) tc be called. This rcutine reorganizes the user's file 
directcry, climinating blank entries resulting from files which 
have Leen erased during the current terminal session, In 
additicn, ICGOUT will execute any CMS command specified as its 
cperand (11STF, fcr example, to oktain a list cf the newly 
cryanized file directcry). 


Y 


Finally, tke skeady message will ke typed indicating in seconds 
the CPU tine used duting thig terminal session for CMS execution 
as well as CMS and CE execution. The revised user file directory 
will be written cut tc disk and contre] will be transferred to 
the CF envircnment. : 


b> 
to 
ice 
in. 
ith 
ea 


ae Given the fact that the user file directory is updated on 
Jick after the completion cf each CMS command, it is not 
necessary tc LUGOUT trem CMS te insure that the user's files be 
saved. 


b. In oder to leg out from the CP-67/CMS system without using 
the LCGCUT cconard, hit the attenticr key once te transfer 
control tc CP and type IOGCUT tc legcut frem the Ccntrel Program. 





Of /¢ 


ch 3.5.10-2 
EE 
ce Fven aif the LOGOUT ccrmand is igssved in CMS, it is aiso 
necessary to log out from the Control Pregram. The CMS LOGOUT 
command car ke bypassed, but the CP logout cemrand must be issued 
to leg off the system and disconnect the telephone line. 


ReT=xxeXxXs/KXe XX hh. wo.ss 

CE ENTEFEL, REQUFST, PLEASE. : 
this message will be typed whenever the LCGCUT command is issued 
in the CMS Ccmmand envircnnent. The first Xx¥.xx is the total CPU 
time in seccrds fcr CMS executicn. The second xx.xx represents. 
the total CPU time in seccnds fcr CMS and CP. These times are 
tatal times for the terminal session. . The keyhcard will then be 
unlocked tc accert any CP ccnscle functicn. : 


Exauglde: 


a. logout 
R3T=TE.9Z/43.21 12.15.28 
CE ENTEBEC, REQUEST, ELFASE. 


fhe compacting ceutine will be called, the indicated message will 
ke typet at the terminal, and centrol will transfer to the CP 
envircnment whare the Keyboard will be unlocked tc accept any CP 
console furcticns. , . 


bE. logcut listf 


The conpacting routine will be called, the LISTF cammand will 
type out the centents cf the reorganized user file directcry, the 
logout message will te typed and c¢cntrcl sill transfer to the Ce? 
envircnment where the keytoard will ke unlocked to accert any 
console furcticn. 


None. 
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3.5.14 STAT : ; : Responses: oe 
: : P-DISK: mnnn RECORDS IN USE, nnnn LEFT (of nnnn), 
Purpose: : nn& FULL (of nnn CYL.) : 


This response is given for the permanent disk, and then for 
the temporary disk, unless P or T was specified, in which case 
information will be given only for the specificd disk. 


The STAT command is used to (1) type out statistics on how may records of the 
user’s permanent and/or temporary disk areas are currently in use, (2) type 
out the current user-defined commands, or (3) execute a routine to compact 
information in the disk management tables. : DEFINED COMMAND(S) = commandl...commandN 

; Up to five defined commands are listed by name. 


Format: 
PSPS ate ee th oon! a elt Daven . NO DEFINED COMMANDS 
: ( Y ‘ P ' This response is given if the user has no defined commands. 
t ' t . < 
a ‘ maw 1 
i <sTaTi 1 9a NO KNOWN T-DISK 
: ) \ D : ' This response is given when T is specified, but no temporary 
: S : Cc ‘ disk is configured on the user's virtual machine. 
t ' ¢ 
: ; Example: 
P specifies that only statistics for the permanent disk are 
to be typed out. : stat 
: ae . 7 P-DISK: 0771 RECORDS IN USE, 0229 LEFT (of 1000), 77% FULL (of 025 CYL.) 
T specifies that only statistics for the temporary disk are T-DISK: 0000 RECORDS IN USE, 0040 LEFT (of 0040), 00% FULL (of 001 CYL.) 
to be typed out. ; DEFINED COMMAND(S) = EMSPRIME SNAPR 
D specifies that only the user-defined commands are to be Since no options are specified, P, T, and D are assumed. 
listed. Statistics for the permanent and temporary disks are followed 
3 7 t + , 
Cc specifies that the compacting routine is to be executed. by the list of the user's defined commands. 
If no operand is specified, P, T, and D are assumed. Error Messages: 
Usage: . : ; None. Be 


The STAT Command will give a count of the records in use on the user's permanent 
and/or temporary disks, the number of free records remaining, the percentage 

of assigned records in use, and the number of cylinders assigncd to the user. 

Disk records are always 800 bytes long. 


‘ Any user-defined commands may also be listed using STAT. These are commands 
which have been written by the user and entered into the system file directory by : 
the DEFINE command. i 


If C is specified in the STAT command, none of the above actions are performed. 
Instead, a routine to eliminate unnecessary space in the disk management tables 
will be executed. This routine is always called automatically when CMS is initial 
program loaded and when the user issues a LOGOUT command to CMS. 


oo 
no 
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i 3.5, 12 
| BLIP AWG 
3.5.12 BLIP ; * 5 
Purpose: : 


The BLIP comr-and causes a string of from one to sient characters to be ‘yped 
periodically during CM5 operation, The BLIP characters are typed out after 
every two seconds of CPU execution and give the user an Indication of the 
execution time of his program. 


Format: , grocer sens Girwis ed a ees ae ' 
' 4 count 
1 BLIP ! chars 1 : 
: ' “2 : 
' ! ee ’ 
! it 
where:. : 
chars is the character to be typed out, and 
count is a digit from 1 to 8 indicating the 
number of BLIP characters 
Usage: 


The default settling of the BLIP char acters is a sequence of non-printing 
characters ~- a shifting of the typing clement from lower case to upper case. 


If it is desired to have a printed recording of the execution of a program, the 
BLIP characters should be changed to printing characters, e.g., a single dot. 
Note: i. 

1. If the count parameter is defaulted a count of l is assumed, 


2. If the first parameter is zero or if both parameters are defaulted, the 
BLIP characters are reset to their non-printing default setting. 


3. If noncharacter codes are desired, the cigtt bytes for the BIIP characters 
can be specified in Nexeeccine! in an Assembly Language Program. 


Error Returns: 
TT Or NES 


None, 


4-01-68 
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, MAPPRT 


sey 


3.5.43 MAPPRT 


Purpose: | 


MAPPRT creates, and optionally prints, a file containing a 
_ map of entry points in the CMS nucleus, 


Format: 
wa val (a) fon Jy] 7 
1 (MAPPRT | | ; : OFF | 
imap Ji lte) Lime fd] 

A creates the file CMS-NUC ALPHABET P1, containing 
the nucleus entry points listed in alphabetical 
order, 

N creates the file CMS-NUC NUMERIC P1, containing 
the nucleus entry points listed in numerical 
order. 

c 


creates the file CMS=-NUC ALPHANUM Pt, containing 
both the A and N orderings. 


ON types out the file at the terminal. 
OFF prints the file on the offline printer. 


NO specifies no output is requested, 


. 
., 


Usage: 


The MAPPRT command creates a file on the user's permanent 
disk containing a list of entry points and their addresses 
in core. In conjunction with a listing of the CMS routines, 
this information allows the system programmer to examine 

,or temporarily modify the nucleus in storage. 


The first option specifies the format of the list. The 
entry points are listed in alphabetic order if A is speci- 


fied. If N is specified, they are listed in the order in 
which they appear in core. I£ no option, or C, is speci- 
fied, both types of list are combined in a single file. 


The filename of the file created is always.GMS-NUC. The 
filetype is ALPHABET, NUMERIC, or ALPHANUM, depending on 
the option specified. See Figure 3.5. 13-A for examples of 
the three types of format. 


The second option specifies whether or.not the file is to 
be typed or printed. ON specifies output on the terminal, | 
and OFF specifies output on the offline printer. If no 
second option, or NO, is specified, no output occurs. The 
file is always left on the permanent disk, whether or not 


output is requested. 
o 
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| oe 
3,5.13-2 4¢/ Ot ee 
MAPPRT ae, : printf cms-nuc alphabet 3.5. 13- 

| MAPPRT 


ASEND AT 00068 

: ACTLKP = =AT O3COF : 
Note:. ACTTAR AT 0O11F8 
ee ACTTAL AT 011F0 


a. . If only one or two addresses are needed, the N option ALTER AT 00000 

avoids the CPU time needed for an alphabetic sort of the ASMADDR AT 00820 

; : i I RATCH AT 00000 

entry points. Any address can be obtained by using the BAT SAT ORDA 

LOCATE request in th EDIT environment, : BCKSPACE AT 0C0G8 

BNEBUG AT ORF 84 

b. MAPPRT should only be issued after CMS has been initialized BUFFER AT OASER 

(by IPL 190), as MAPPRT uses tables set up ‘by the nucleus CARDPH AT O0C2R8 
loader. 


Responses: 


None, except.under the ON option, the file is typed out. printf cms-nuc numeric 


ALTER AT 00000 


Examples: BATCH AT 00000 
e ERASE AT 00000 

a. MAPPRT : . OFFLINE AT 00000 
With no options specified, both the default options are taken. ( SYSCTL AT 00000 


TAPEIO AT 00000 


The file CMS-NUG ALPHANUM PI is created, containing 
UFDFLG AT 000060 


both an alphabetic and a numeric listing of the nucleus entry 


NUCON AT 00100 ° 
points, USFL AT 00108 
; de: STADOR -AT 00110 
b, MAPPRT C OFF TBLNSG AT 00118 
The same action is taken as in Example a, and the file is LSTADR AT 00104 
printed on the offline printer. LOCCNT AT 001C8 


Error Messages: . 


None 
printf cms-nuc alphanum 


ABEND AT 0C068 ALTER AT 00000 

ACTLKP AT O3COE BATCH AT 00000 

ACTTAR AT O11F8 ERASE AT 00000 

: ; ACTTAL AT 011F0 OFFLINE AT 90000 
‘ ALTER AT 00000 SYSCTL AT 00000 
ASMADDR AT 00720 TAPEIO AT 00000 

RATCH AT 00000 UFDFLG AT 00000 

SATSWT AT OA2CA MUCON AT 00100 

BCKSPACE AT 000628 USFL AT 00108 

BOF BUG AT O8F84 STADOR AT 00110 

( , BUFFER AT OASF8 TBLNG AT 00118 


Figure 3.5.13-A. Samples of the three types of nucleus map files 
created by MAPPRT. Only the first few entrics of each are 
shown. 
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wh 4/3. 
3.5.14 IPL 


Purpose: 


IPL causes a new copy of the CMS nucleus to be initial program loaded,’ 


Format: 
ae Sie get Pree 4 
1 IPL 7 
ae 7 ' 
‘ J \ 
Lee seecte ce | 
Usage: 


This command performs the same action as the IPL console function. 
Both will cause the CMS nucleus to be initial program loaded, although 
the copies of the nucleus which are brought in will not necessarily be 
the same in both cases. 


The IPL command and the "IPL 190" console function will load in the 
copy of the nucleus which resides on disk 190. | Periodically, a copy 
of this nucleus is saved by a CP utility. The "IPI. CMS" console 
function will load in this ''saved" copy of the CMS nucleus. This 
means that if the nucleus on 190 has been modified since the last copy 
was saved, the versions referenced by the IPL command and the IPL 
console function will be different. 


* 


Response? 


CMS... VERSION 1.0 - 05/01/68 
This response indicates that a new copy of the nucleus has been 
loaded and that control has transferred to the CMS Command 


environment, 
‘Example: 
a. +. > ipl 


CMS... VERSION I.0 - 05/01/68 
A new copy of the CMS nucleus has been initial program loaded and 
the keyboard will be unlocked to accept any CMS comrnand, 


Error Messages: 


None, 





: : 11/01/68 


3.5,15-1 
; tf RT pe 


3.5.35 RT 


Purpose; 


The RT command restores the typeout at the console previously suppressed 
by the KT command. 


_ Format: 


ore ee ee ee 


oe ee 


e 
The RT command restores console typcout from an executing CMS command 
or- user program that was previously suppressed by the KT command. In 
order to enter the RT command meaningfully, the attention key must be hit 
once to interrupt execution and transfer control to the CP environment and 
then a second time to transfer control to CMS, Program execution will 
continue but the keyboard will be unlocked to accept user input. Vyping RT 
at this point will cause all further console output from the executing command 
or user program to be typed out. Execution will continue to normal program 
completion. 


Notes: 


° a. Entering RT as a normal CMS command will have no effect. RT has mean- 
ing only after two attention interrupts have been generated during program 
execution, 

b. = If the keyboard does not unlock following the second attention interrupt, 
internal processing is probably taking place which does not allow inter- 
rupts from the multiplexor channel. As soon as this processing is 
completed, the keyboard will be unlocked and RT may be entered. 


c. The character-delete symbol (@) and line-delete symbol (¢) are not valid 
when issuing an RT command. 


Example: . 
a. RT 


Assuming that the attention key had been hit twice prior to typing RT, 
CMS will restore any console output generated by the program in progress. 


Error Messages: 


None, 
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3.9.16 CHAREEE ' ara 3.5.16-2 
65 Fh Exanzles: ¢b6 ALE 
Eucrose: 
. Be CHABLEF C ? é 
The character delete symbcl is no» defined as ?. The @ can he 
CHARDEF redefines the logical characters that correspcnd to used as a rermal character. 
hatdware fencticns. . 
r. CHAEEFFE L 
Ecrmat: : The line delete symbol no lcnger exists. The ¢ can ke used as 
: ‘ @ nermal character. 
: ack BELQI Message: 
( CHARDEE | ftuncticn <reslacement character> | 
| j code \ 28 vee 
wrt tr tt rer rr et et re ; ey £(00001) - Illegal function code was specified. 
: a . 
functicn ccde E signifies the EDIT legical 
backspace character. 
Cc Signifies the character 
delete synmtol. 
1 denotes the line delete syrkol. 
{ 
T signifies the EDIT lcgical 
tab character. . 
replacenent is the character to be used fer 
character the specified function. If a replacerent 
: a ‘ character is nct ssecifiei, there will By 


ke no symtol for that furcticn. 


The predefined characters in CMS fcr the character delete symbol 
“and the line delete symbol are the @ and ¢ respectively. If a 
character is net specitied with either chardef C or chardef L, 
there is ne delete symbol for a character cr a line. 


The predefined loqical tak character ard kackspace character in 
EDI21 are the 4 and the * respectively. If.B cr T is specified, 
EDIT and CELII cconsands will cause reference tc be made to the 
redefined synbcls each time either editor is invoked. 


Ihe functicn symbols that are redefined renain in effect until 
€ither (1) CMS is re-IPLed, (2) ancther CHARDEF ccmmand is 
issued, c1 (3) the user loge out of CP. 





05/01/6: 
3. Hi 7 
2.2.17  CPFUNCIN ey A 


Fygrcse: . . 


Ine CPFUSCIN ccmmand transmits console function commands tc CP-67 
withcut lezving the virtual srcde cf cpferation. 


Ecrmat: 

! 

{ CPEUNCTN 4 <NCMSG> String 1 

I CEF ! fi « 

OS eh, oe) ae es a oS 
NCMSE cpticnal argument tc turn cff typing 
of "BAL ARGUMENT* and "INVALIP CP 
REQUEST* messages. 

; string a CP-67 ccnscle furcticn. 
Usaag: 


CEFUNCIN is provided tc ‘allcw CE-67 conscle functicns to ke 
issvcd fren CMS and to ke incorporated in EXEC files. 


» 


Egcoc ess 3aces: 


—oaRese = 


£(00C01) FUNCTION MISSING 


Ne string was specified with the ccomand, 


E(CCCQ4) INVALIC CE BEQUEST : 
*strirg' ig nct a groper CE-67 conscle functicn. 


E(COCOS) HAL ARGUMENT 
The arguments supplied are net percper fer 
tte specified ccnsecle function. 


E(XxXxxXxX) Any other errcr ccedes are dependent on the 
particular console function desigrated, 


fxapeles: 


1. 


CPEUNCIN XFER OOD to csc 
Executes an XFFR ccngeole function. 


CPF hOMSG DETACH COE , 
Executes a DETACH command. If OOF is not 


@ valic address, the BAD ARGUMENT neesaye 


hill nct be typed. 
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3.5.18 


DIVERTSW 


Purpose: 


Format: 


Usage: 


Responses: 


Notes: 


11/07/69 
3.5.18-1 


DIVERTSW .- 


The DIVERTSW command will set a switch either 
on or off for diverting certain terminal output 
to the offline printer. Output for Fortran 
logical unit 6 and PL/I FILE SYSPRINT can be 
diverted to the printer without an intermediate 
file being created on the P-disk. 


DIVERTSW [ON 
OFF 


DIVERTSW ON sets an indicator which is later 
tested during either Fortran or P1/I execution. 
Subsequently, all output destined for the 
terminal will be diverted directly to the 
offline printer. This command can be convenient 
whenever large amounts of output are expected 
and P-disk space is too small to accommodate 

the output. 


DIVERTSW OFF will reset the indicator to output 
to the terminal. 


NONE. 


a. DIVERTSW does not close the printer 
automatically. Therefore, the user 
must close the printer file after the 
program completes execution. This is 
done in CP with the CLOSE function 
CLOSE OOE, or with the CMS command 
CLOSIO PRINTER. 


doe. 


3.5.19 


TIMELIM 


Purpose: 


Format: 


Usage: 


Responses; 


Note: 


Examples: 


Errors: 


11/07/69 
3.5.19-1 
TIMELIM 


465, 2. 


The TIMELIM command will set a time limit for 
the execution of any command and terminate 
execution 1f the time limit is exceeded. 


al [na] 
TINELIM | 10 


OFF 
where nl = number of minutes 
n2 = number of seconds 


TIMELIM nl n2 will establish a time limit of 

nl minutes and n2 seconds for the command which 
immediately follows TIMELIM. If the execution 
of the subsequent command exceeds the time 

limit, execution will be terminated. If the 

job is completed within the time limit specified, 
the time limit is no longer in effect. TIMELIM 
with no parameters sets the time limit to a 
default value of ten minutes. 


TIMELIM OFF nullifies the effect of a previous 
TIMELIM command. 


TIME LIMIT EXCEEDED.....EXECUTION TERMINATED, 
This message is printed immediately before a 
KX is issued. ; ; 

If a 1IMELIM command has been specified, no 
"blips" will occur during the execution of the 
timed job. 


a. TIMELIM 14 
$ FORTPROG : 


b. LOAD ITERATE SUB1 SUB2 
TIMELIM 35 30 
START 


none 





3.5.20 


Purpose: 


Format; 


Usage: 


Responses: 


Notes; 


11/12/69 gies 
3.5.20-L dtc 
GETLIB 


GETLIB 


The GETLIB command permits access to files on a 
library disk. 


Fae devadd |PASS= rocco] | 
OFF 


GETLIB 
Userid specifies the owner of the disk to be 
accessed 
Devadd the owner's virtual device address in 
hexadecimal 
XXKXXXKXXK  read-share password of the library disk 
OFF discontinues the use of the library disk 


GETLIB is provided so that many users may share 

a common library of files. It is a space-saving 
mechanism designed to eliminate the need for 
storing duplicate copies of certain seldom-modified 
files on several users' P-disks. 


Issuing a ''GETLIB userid devadd'"' command will provide 
access to a library disk via the following sequence 
of events: Device 192, if it exists, is detached; 
GETLIB then LINKS to the userid's devadd as 192; 

and finally the tables which reside on the library 
disk and describe its contents are read into core. 
GETLIB OFF detaches device 192 and clears the core- 
resident tables associated with that device. GETLIB 
with no arguments requires that device 192 is already 
attached. It then makes the linked disk accessible 
as a library disk, 


DEV 192 DETACHED 

Either a ''GETLIB OFF'' command has been executed, 

or ''GETLIB userid devadd" has been issued subsequent 
to other GETLIB commands, 


a. In accessing files. the P-disk will be searched 


Error messages; 


E(00001) 


E(00002) 


Examples; 


1. 


3. 
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GETLIB 


before the library disk. 


All files which reside on a library disk are 
temporarily assigned the mode letter, T, by 
CMS. 


All library files are read-only. 


The ability to specify a password in the 
GETLIB command itself is provided for added 
flexibility. It 1s specifically designed 

for use in EXEC procedures. However, the user 
is cautioned to set type-out of CMS commands 
off (&TYPEOUT OFF) to prevent the printing 

of passwords on the terminal sheet. 


An invalid GETLIB argument has been detected, 


GETLIB has been issued with no arguments, and 
no disk has been attached as device 192, 


GETLIB LIBMACH 191 
Device 191 of LIBMACH is attached and its files 
are made available for use, , 


GETLIB OFF 
The library disk is removed. 


GETLIB 
User's device 192 now becomes a library disk, 


¢ 
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QUICK 


3.5.21 QUICK 


Purpose: . 


The use of the QUICK environment allows the user to create, o 
edit, compile (or assemble) and execute files without 
continually referencing the file by its identifier, 


Format: 


x 


Tf 


) | PL/1 


filename specifies the filename of the file 

: | on which operations are to be 
performed. 

filetype specifies the filetype of the file 


. on which operations are to be performed. 
If the second argument is omitted, a 
filetype of FORTRAN is assumed. 


Usage: 


The QUICK exec procedure is entered. Filename is the name of 
the program to be created, edited, compiled, or executed. 
SYSIN indicates the program is written in assembiy language, 
PLI indicates a PL/1 program, and FORTRAN indicates a FORTRAN 
program. | 


An asterisk is typed at the terminal upon successful entry into 
QUICK and after the completion of subsequent QUICK requests. 


QUICK Requests: The requests described on the following pages 
are valid in the QUICK environment. Some of the requests, 
however, are not valid for all three languages. QUICK 


responds to invalid requests with the message: INVALID QUICK 
REQUEST : 


EXAMPLES : 


1) QUICK TESTFILE | 
QUICK entered-operations to be performed on the file, 
TESTFILE FORTRAN, 


2) Q EXAMPLE SYSIN 
QUICK entered-operations to be performed on the file, 
EXAMPLE SYSIN. 


| 


11/12/69 
35562)-2 


QUICK 


| C ERROR MESSAGES: 


1) WRONG ARGUMENTS-CMS ENTERED 
Retry with valid arguments. 


11/12/69 





3.5.21-3 
QUICK 
CMS 
Format: 
Usage: 


The CMS request unlocks the keyboard so that a CMS command can 
be entered; this command is executed immediately and control is 
then returned to the QUICK environment. 


Note: Any CMS command may be entered following the CMS request. 





Error Messages: none 
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QUICK 
COPY 
COPY 
Format: 


COPY 


Languages: Fortran, Assembler, Pl/1 


Usage: 
The COPY request saves a copy of the current file as filename 


EXTRA*** Pl. If filename EXTRA*** Pl exists, it is erased 
before the fresh copy of the current file is created. 


Error Messages: none 
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QUICK 
DATA 


DATA 





Languages: Fortran, Assembler, PL/1 


Usace: 


The DATA request provides the user with the capability of 
specifying only once the terminal input to the current program. 
This is accomplished through the automatic creation of a file 
(DATA**** EXEC) which is saved on the user's P-disk, 


If the user issues the DATA request with no parameters, QUICK 
responds with: 


ENTER INPUT DATA 
NEW FILE 
INPUT: 


The data which would normally be entered from the terminal is 
then entered in the format expected by the program. Multiple 
lines are permitted. When the desired data has been entered, 
hit an extra carriage return and upon receiving the system 
message, EDIT:, type FILE. This saves the data entered and 
returns to the QUICK environment (an asterisk is printed). 
Fach time the $ request is issued, the data entered via the 
DATA request is stacked in the terminal input buffer such thet 
each programmed read to the terminal obtains the desired input 
directly from the input, buffer. When the user's program has 
read all the stacked input lines, remaining terminal read 
requests unlock the keyboard and the appropriate input data can 
be keyed in normally. 


To suspend data stacking once the data request has been insured, 
the DATA request is reissued with the OFF argument. Similarly, 
the ON argument resumes data stacking and can be used to activate 
a DATA request issued in a prior QUICK session. 


’ Notes: 
1. When the DATA request is issued with no parameters, and a 
DATA**%%* EXEC file currently exists, the current file is 
erased and a new DATA**** file is created. 


2. The DATA option is initialized to the OFF state each time the 
QUICK procedure is invoked. 


Error Messages: None 
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QUICK 
EDIT 
EDIT 
Format: 


EDIT 
E 


Languages: Fortran, Assembler, PL/1 


Usage: 


The EDIT request is identical to the CMS command, EDIT filename 


filetype. If the file specified to QUICK does not exist, it 


is created for input. Otherwise, the existing FORTRAN, SYSIN, 
or PL/1 file can be edited. The CMS edit requests, FILE and 
QUIT, return control to’the QUICK environment (an asterisk is 
printed). 


Error Messages: none 


OK 


poe 
Languages: Fortran, Assembler, PL/1 


Usage: 


11/12/69 
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QUICK 


OK 


The current file is compiled (fortran and PL/1) or assembled 


(assembly language). If processing is successful, 
TEXT is created on the user's P-disk. 


Error Messaces: none 


filename 


| 11/12/69 
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- , Ss QUICK 
¢ PRINT 


PRINT 
PRINT [ ues | 
P 7 


Languages: Assembler 





Description: © 
The PRINT request prints the LISTING file created when the 
current file is assembled. If the argument HERE is supplied, 
the LISTING file is printed at the terminal. Otherwise, the 


file is dumped to the high speed printer at the computer 
center. | 


€ Error Messages: none 
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QUICK 
QUIT 


QUIT 
QUIT 
Q 


Languages: Fortran, Assembler, -PL/1 


Description: Control is returned to the CMS command environment. 


Error Messages: none 
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| ‘4 2" | | QUICK 
C | 4 | SUB 


SUB 


oe 


Languages: Fortran, Assembler, PL/1 


Description: 


The SUB request allows the user to specify up to three TEXT 

routines which will be loaded with the current program each 

time the $ request is issued. When the SUB request is issued, 

QUICK responds with "ENTER SUBROUTINE NAMES." The routines 

then specified will be loaded with the main program until the 

SUB request is issued with the OFF argument or until the user 
¢ leaves the QUICK environment. 


Error Messages: 


1. TOO MANY ROUTINES - CMS ENTERED 
Return to the QUICK environment with the QUICK CMS command. 
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Languages: Fortran, Assembler, PL/1 


Usage: 


The TEXT version of the current file is loaded and executed. 
The SUB request can be used to specify additional TEXT 
routines to be loaded each time the current program is executed. 
If a PL/1 program is to be executed, QUICK insures that PLILIBI, 
PLILIB2, and PLILIB3 are specified in the (LIBE) option at 

load time. If the argument, HERE, is supplied, SYSOUT for a 
PL/1 program is directed to the terminal. 


Error Messazves: none 


oe 
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DOSBATCH 


3.5.22 DOSBATCH 
¢€ - PURPOSE: 

The DOSBATCH command provide simple transfer of job files to 
the DOS batch machine, and allows the user to select the manner 


in which he receives output from these jobs. 


FORMAT: 






DOSBATCH | fn £t Coptions> 
| BATCH DOS 


Gefaults The default filename is BATCH and the default filetype 
is DOS. | | 


OPTIONS: 


tions determine where printed or punched output should go, 
either to the real device in the VCS computer center, or to the 
.user's virtual reader. If no options are specified, the output 
will be routed to the appropriate real device. 
¢€ LIST (or L) will return printer output from the batch 
= job as a file in the user's reader. 


DECK (or D) will return punched output from the batch 
job as a file in the user's reader. 


eo: Cie 
CG 


o Ss osed in parentheses. Either one or both 
tions may be spe af 


to 
=e 
ified. To specify both, a blank must separate 


DOSBATCH short fortran (list deck) 


If both options are specified, 2 files will be returned in the 
virtual reader. | 


USAGE: 
The DOSBATCH command will transfer the one file specified to the 
batch machine to be run under DOS. Appropriate job control must Le 
included in the file. 


RESPONSES: 





a. R: hh.mm.ss 
bh, FILE NOT FOUND 
E (00001) 
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DOSBATCH 
3.5.22 DOSBATCH 
EXAMPLES: 
ae DOSBATCH 
Uses the defaults. Sends the file BATCH DOS with no options. 
b. DOSBATCH ROOT (DECK) 
Uses the default filetype. ROOT DOS to be run under DOS. 
Any punched output will be returned asa file in the user's 
reader. 


c. DOSBATCH SHORT FORTRAN {LIST DECK) 


The file SHORT FORTRAN will be transferred to be run, and 
both printed and punched output will be returned as reader 
files. | 


NOTE: 
The default filetype cannot be envoked unless the default filetyve 
is also used. For example, to transfer the file BATCH COBOL, 
the command: 


DOSBATCH COBOL (Options) 


would be invalid since "COBOL" would be looked upon as filename 
rather than type. 


3.6.0 UTILITIES 05/01 


3.6.01 EF 


This section contains those CMS commands which are utilitarian 
in function. They include SORT, which sorts a disk file, 
COMPARE, which compare two disk files record by record, 

TPCOPY, "which copies a tape, MODMAP, which types out the 

load map of an existing MODULE file, and TPMATCH, which 
compares two magnetic tape files. 


05/01/69 
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3.6.1 CNVI26 | : fg Heit 
Purpose: 


“the CNVT26 command converts a BCDIC (026) card-image file to 
EBCDIC (C2S). 


os 


I | 
{| CNYT26 ! filename filetype j 


tilename filetype is the file to ke converted, 
Usage _ 4 * 


The specified file is searched for cn the P disk and then the T 
disk. The old file is erased and the new file is given the 
original name, type, and mcde. 


CNVT26 creates the work file "ECDEBC UTILITY" with the same 
filemode as the file tkeing converted. If a file vith the 
identifier “ECLEBC UTILITY" already exists, it will be erased. 


Examples: - 
a. CNVTZ6 EASY FORTRAN 


The file EASY FCRTEAN is converted from BCDIC to EBCDIC, the old 
file is erased, and the new file is given the orginal name, 


| Error Messages: 


£(00091) FILE NOT FOUND 
The specified file does not exist on either the P disk or T disk. 


E (00002) FILENAME (5S) MISSING 
®ither the filename and/or filetype were not specified with the 
command. kKeissue the cereane Bereror ay 
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3.6.2-1 3.6.3-1 


5 / 
. . sete 3.6.3. CVIFY LE 
COMPARE . G79. 
3.6.2 COMPARE - . Purrose: | 
Purpose: — ; The CVTFV ccsmand cenverts a file with fixed length recerds to 


variable length records. 
The COMPARE command. can be used to compare two disk files. 


Format: : Format: 
Poe Ge ee IM Re ae ap ee A ae Le Eo ee ae 
{COMPARE j * filename} - filetype 1! filename2 filetype2 ! 
Pye ar ey eae eile es eat he ev eso ew a as De ee eee bee bee ere eee SS ee ae a aS ee eee Se) an at Se ee a 
Usage: zi : | | 
a ; { CVTFV j filename filetype <(T)> | 
j If the files are identical, a message will so indicate. If corresponding j Ot { 


Ce | 


records in each file do not agree, tic record from the first file will be 

printed followed by the record from the second file. If the end of one 

file is reached before the end of the other, a message will so indicate. 
: filenase fililetyrfe is the file to be ccnverted. 


The m-~{wum record size that can be COMPAREN(%s 256 characters. 


(T) specifies that all trailing 
Responses: ‘ 4 tlanks are to be deleted. 
( EOF FILE n 
The end of file has been reached on file n, where n is either ] or 2. Qs3je: 


NOT EOF FILE n 
This message Ww: '11 follow EOF FILE n if the end of file is reached on one 
file prior to that of the other file. 


If (1) is specified and the file ccnsists cf 80 character 
cecords (a normal card file), kytes 73 through 80 of each 
card image will re deleted regardless cf contents. Therefore 


~ FILES HAVE DIFFERENT CHARACTERISTICS tc cenvert card files without loss of information in 
The files being compared do not have either the same record size or columns 73 thrcugh 80, de not use the (1) cption. 
record format. : : 
The P disk and the T disk are searched fer the specified 
file. The old file is erased and the new file is given 
the original name, type, and mode. 


; PARAMETER ERROR ~ 
Insufficient parameters were. supplied. . 


RECORDS ARE TOO LONG 
The records are longer than 256 characters, therefore they can not be 


‘compared . CVIFV creates a work file with a filetype c£& CVTOT1 and 


the filenane and mcde cf the specified file. If a file 
already exists with the sare identifier as the work file, 


Error Messages: 2 ot : it wlll’ be erased: 
E(00001) ; FILE NOT FOUND 
E(xxxxx) FATAL ERROR 


fxatgles: 


; ; ae CVIFV USERGUID SCRIPT (T) 
( . The file USERGUID SCRIPT is converted from fixed length 
- ’ records tc variable length cecords. If the file contains < 
» 80 character reccrds, cclurns 73-80 are deleted. 
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f73 CUed 3.6.4 MGDEAE _ aS 
Error Messages; ‘ | ia | = YS 


E (00001) FILE NCT FCUNT 


the specified file dces nct exist cn either the P disk 


€ The MSCTHAE command types the lead sep associated with the 
Ck T disk. 


‘specified MODULE file cn the ccnscle typeyriter. 


E(00002) INCORRECT FCENAT Pernat: : . 
A T was net specified between the rarentheses, ee wee 


£ (00003) INCCERECT FCEMAT : 


se i ! i 
Fither a filename and/cr filetype was not specified { MCDEAE } filenase ] 
with the command. Reissue the ccmmand correctly. ; 1} { ! 


Oe et ee te ee SY 


£ (00004) FILE IS ALREALY VARIABLE 


The specified file ccntains variable lenqth records, filename filename of a file whose filetype is MODULE 
therefcre it can not be converted. : : 


Usage: 


the lcader table which was in use at the time the GENMOD was 
issued tc create the MCDULE is typed on the ccenscle typewriter. 


Any KOBDULE files created sith the GENHMOL (NOMAP) conamand dc not 
ccentain a load map. 


3 ¥ 


RESPODSES; 


LOAD MAP UNAVAILABLE 


the MCBULE file was created with tke («SOMAP) cetian of GEXMCD, 
‘therefore the lcad naz dces net exist. 


05/01;09 
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3.6.5 SORT Yig Gea 
Furpose: 


SUFI arranges the records from file 1 into file 2 in ascending order 
according to szecified scrt fields. 


-_ mmm we 


filename! filetype ais the input file 
. : to be serted. 


filenanez filetype2 is the output file 
that contains the 


secrted reccrds. 


Ihe records are sorted in FECDIC order from filel to file2. 
It duplicate recerds are fcund, they are written onto file2 
in the ordér in which they are encountered in filel. Ali 
records must te cf fixed length tc be sorted. 


» 


Filel and file2 must have unigue identifiers as SORT can net 
woite the cutput back intc the input file (file1). If the output 
file already exists, either the old file can be erased, or the 
sort can te terminated, cre the existing file can be appended with 
the autput, or a new output file can ke specified. 


Cnce the SCKT command is issued, it asks fcr the sort fields 
to ke defined via the fcllcwing message: 


: *ENTER SCKT FIELD CEFINITICNS 


The sort fields are defined hy typing pairs of numbers, separated 

by tlanks, where each rairc is the starting and ending 

Character fosition of a sort field within each input record 

and the leftucst fpaic is the majer sert field. 

Ine’ total number of pairs cf sort field definitions that can be 

entered is limited only by the raximnur number of characters that 

can be typed on one line and the maxinum numker of characters in 
. 6 


Exanel 
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Y ft, BAY 


The total number otf characters on which the records are to be sorted 


the defined sort fields. 


" must not exceed 254 characters. 


The sorting operation takes place with two passes of the input 

file. Pass cne creates an crdered pointer table in core storaqe. 

Pass two uses the pointer tattle to read the input file in a randcn 
tanner and write the output file. Therefore, the size of core storaqe 
and the size of the sort field is the liriting factor on the number of 
records that can be scrted at any one time. An estimate of 

the maximun number of records that can ke sorted can be nade by using 
the follcwing formula: 


BLOCK 
NR = 14 + NC 
wheres 
NR is the maxizum number cf input records 


NC is the total number of characters in the 
defined secrt field. 


Besecnses: 


*ENTEF SCRT FIELC CEFINITICNS = 
[etine the character positicrs cn which the records are to 
be sorted. Type pairs of numbers, separated by blanks, where 
each pair is the starting and ending character position of 
a sort field within each input record. 


*CUITECT FILE ALREALY FXISTS, TO APPENDT IT, HIT RETURN. 

*TC EFASE CLD FILE, TYFE *ERASE®. 

*TO QUIT, TYPE "QUIT', ELSE ENTER NEW FILNAN/FIITYE. 
File2 already exists. Either erase the cld file, terminate the 
sort, cr specify a new cutput file. 


XXXX RECORDS READ ON PASS1. - : 
The tctal number of records read freer the input file is XXXxX. 


Ic 
in 


ae SGRT CLASS MEMO ALFECLAS MEMO 
fort Class memc alphclas nemo 
SENTER SCHT FIELE DEFINITIONS 
1 10 25 28 . 
66 RECCRIS REAL CN PASS1. 
R;T=C. 3071.06 15.C6.47 





- 4 08/01/. » 
Soy 3. 6.5-+3 ; 
the 66 recerds in file CLASS MEMO are sorted on positicns AGS, 


1 through 10 and 26 threugh 28. The sorted output is written. 
intc cae newly created file ALPHCLAS MEMO. 


SEL ree 


B (00601) * INPUT FILENAME/FILETYPE NOT DEPINED. 
Eoth the filename and filetype were not specified 
for filel. : 


E (00002) *CUTPUT FILENANE/ FILETYPE Nor DEFINED. 
Foth the filename and filetype were not specified for 
file 2, 


£(00003) * INCOMPLETE SORT FIELD PAIR CEPINITION. 
Cn ending character position was nct specified for 
a sert field. 


“B(c0005) *INEUT FILE DCES NCI EXIST. 
the file specified as filei dces nct exist, 


E(CC006) *INPUT PILE If NOT FIXED LENGTH FCRMNAT. 
fhe records in file1l are not fixed length, therefore, 
they can net ke sorted. 


£(¢C010) CANNOT ERASE INEUT FILF 
; » Yhe identifiers for file1 and file2 are the same - they 
'* gust be unique, as the input file can not be erased. 


» 
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3,6, 6 TPCOPY 


Purpose; 
The command TPCOPY can be used to copy tape files, 





Format: 
('TPCOPY {| TAPi TAPo on YES: 
' » TAP) TAP2 1 no 
t i % x x x ! 
eaues aged Iuweinw aah eieaecncee seeekeee ue biene chine ‘ 
where 
TAPi is the input*® symbolic tape unit . 
TAPo is the output symbolic tape unit 
n is the number of files to be copied 
YES, types out a summary of cach file copied, 
If YES is not specified, no summary is assumed. 
* : specifies the default is to be taken for each parameter. 
Notes; 


1, 7 track tapes are read and written at 800 bpi, odd parity, converter , 
on, translator off, 


f 8 
2. If TAGI and TAFo are'not specified, TAP] and TAP2 are assumed, 
which correspond to 180 and 181 respectively. : 
ped. 1 ; 
3. Ifnis not specified, the default is. one file to be copied. 


» 


4, The maximum record size is 4096 characters, 


Responses: 


SUMMARY OF COPY 
The YES parameter was specified with TPCOPY, therefore a summary 
of the copy of each file is typed out, 


FILE xxx 
The xxx is the sequence number of the file being copied on the tape. 


xxxxxxx RECORDS, LENGTH = xxxxx BYTES 
The number of records on TAPi and the maximum length of each 
are specified, 


Xxxxxxx RECORDS COPIED 
The xxxxxxx is the number of records copied from TAPi to TAPo, 


F SUMMARY COMPETE 
The summary typcout has terminated. 
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TPCOPY Lrg 
ees “7 


TAPE READ ERROR; BYPASS? (YES/NO) 
An error has been encountered while reading the tape. The keyboard - 
is unlocked for either a YES or NO response. If YES is entered, 
TPCOPY skips the error record, and vontinues reading. If NO is 
entered, error code 1] is returned and TPCOPY terminates. 


SUMMARY TABLE OVERFLOW; SUMMARY CANCELLED 
The summary has been cancelled. 


Error Messages: 


E(00001) TAPE WRITE ERROR; TERMINATING. 
E(00001) ILLECAL FILE COUNT FIELD. 
E(00003) SAME UNIT REQUESTED FOR INPUT AND OUTPUT 


we 


3.6.7 


-TPMATCH 


Purpose: 


Format: 


Usage: 


Responses: 
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3.6.7-1 
TPMATCH 


The TPMATCH command will compare two magnetic 
tape files. 


TPMATCH 


One tape is mounted on device 180 and the other 
on device 181. Both are rewound to the load 
point, and the TPMATCH command is issued. The 
contents of the tape files are compared until an 
end-of-file condition is reached on either tape 
or two records which do not agree are encountered. 


END OF FILE ON TAPE 1 
A tape mark has been read on the tape at device 
180. 


TAPE ERROR ON TAPE 1 


An unexpected tape error has occurred on the 
tape at device 180. 


END OF FILE ON TAPE 2 : 
A tape mark has been encountered on the tape at 
device 181. 


TAPE ERROR ON TAPE 2 
The tape at device 181 has a bad record. 


LOGICAL RECORD LENGTHS NOT EQUAL. 
Program terminates if record sizes disagree. 


TAPE FILES ARE NOT IDENTICAL 
TPMATCH has encountered two records which do not 
agree, 


RECORD # NNNNNN WAS THE ‘LAST RECORD READ. 
This message indicates the record number of the 
first records which did not match. 





3.7.0 


Vig 
: 90 
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3.7.0 


TEXT Libraries 


P eo 8 h 
TEXT libraries are used by the LOAD, USE, and REUSE commands to searc 
for missing subroutines during loading. Uniess the GLOBAL LOADER TXTLIB 
command is issued, LOAD, USE, and REUS.2 search only the TEXT libra.y 
named SYSLIB, 


For more information on library usage, refer to section 5. 4.0. 





Ai 
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3.7.1 SYSLIB TXTLIB 


The brary SYSLIB TXTLIB contains the FORTRAN Library as well as a 
number of CMS library subroutines. The TXTLIB directory indicating the 
entries in the library is shown in Figure 3.7,1-A. Refer to Form.C28-6596, © 
FORTRAN IV Library Subprograms (Prograr> Numbers 360S-LM-501l, ane 
360F-LM-619), for a description of the routines from the FORTRAN library. 
This section contains the descriptions of the subroutines written for use under 


CMS, 


The routines described are? 


TAPSET 


3. 7. 1. 1 
TRAP 3.7.1.2 
BLIP 3.7.1.3 
LOGDSK 3.7.14 : 
REREAD 3.7.1.5 
DEFINE Se ielea? 
DSDSET 3.7.1.7 
GETPAR 3.7.1.8 
CPNMON/CPNMOF 3.7.1.9 


wt 
a 


ENTRY 


HICCGOTO 
CaoTo?F 
IHCCLASS 
CDABS 
THCCLAS 
CDHUPY# 
CDODVD? 
HHCCLEXP 
CDEXP 
IHCCLLOG 
CDLOS 
CDLGI10 
tHCCLSCN 
CDSIN 
cocos 
IHICCLSQT 
COSART 


THCCSABS ° 


CABS 
THCCSAS 
CHPY# 
CDVDE 
VHCCSEXP 
CEXP 
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3.7.1.1 TAPSET Routine 


Purpose: 


The TAPSET subroutine changes the default settings for the FORTRAN logical 
tape units. 


Calling Sequence: 
CALL TAPSET (tapno, dsrn, < blksize>, <modeset, <recfm > <lrecl>) 


where: : 
tapno is an iteger on 1 to 4 indicating the virtual tape unit 
TAP], TAP2, TAP3, or TAP4 corresponding to device 


address 180, 181, 182, or 183. 


the FORTRAN data set reference number that will be 
- used to reference the specified tape unit. 
must be from 1 to 14 with exception of 5,6, and 7. 


dsrn 


blksize is the byte count for the maximum size of the physical 


records to be read or written on the defined unit. 
modeset is a code number for setting the mode mask for 7 
track operations. The mask is ignored on all 
9 track operations. 


‘ 


The code numbers range from 1 to 15 in groups of 5. 
Codes 1-5 are for 800 bpi, 6-10 for 556 bpi, and 11-15 
for 200 bpi. Within each group of 5 the mode setting 
is as follows: ; 


1) odd parity, converter on, translator off. 
odd parity, converter off, translator on 
3) odd parity, converter off, translator off . 
even parity, converter off, translator. on 
5) even parity, converter off, translator off 


ef 
Nw 
— 


recfm is a type number from 1 to 5 indicating the record 


format. 


fixed record size, unblocked 

2) fixed record size, blocked 

3) variable record size, unblocked 
4) variable record size, blocked 

5). undefined record size, no blocking 


is the byte count of the logical record to be read or 
written. It is used for record format types 1 through 
4. For type 2 records, blksize must be an integral 
multiple of lrecl; refer to the Fortran 1V (G) Program- 
mer's Guide, C28-6639, for a discussion of irecl and 
blksize for variable type records, 


lrecl — 


This number 


The type numbers are: \ 


: | ue aw ty 
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TAPSET 


If the parameter biksizée, modeset, recfm, or lrecl is zero or omitted, the 
parameter will be defaulted to that which was previously set or defaulted for 
the tape unit. 


Usage: 


FORTRAN data set reference numbers ll-}4 are the standard logical tape units. 
These units correspond to symbolic devices TAPI-TAP4 and to virtual devices 


180-183. The default settings are as follows: 
Virtual Symbolic Data Set Block Modeset Format Logical Recorc 
Device Device Reference Number Size Code Type Length 

180 ‘TAP | 11 80 1 1 80 

181 TAF 2 12 133 1 1 133 

182 TAP3 13 800 1 2 80 

183 TAP4 14 1330 1 2 133 


The parameters blksize, modeset, recfm, and lrecl are associated with the dsrn. 
Ifa call to TAPSET is made with these settings defaulted, the settings previously 
associated with the dsrn will still be in effect. Ifa call to TAPSET associates a 
tape unit with a dsrn which is already associated with a tape, the tape previously 
associated with that dsrn will not be associated with any logical unit. If a call to 
TAPSET associates a tape unit with a dsrn different from that with which it was 
previously associated, the previous dsrn will be associated with disk files. If a 
call to TAPSET associates a tape unit with a dsrn which was previously associated 
with a disk file, a read or write to that dsrn will be directed to the tape unit. 


If the blocksize is defaulted, the following message is typed at the-terminal or on 
sysout, 
, 


TAPSET~-BLKSIZE IS ZERO OR NEGATIVE; DEFAULT USED, 


If the logical record length parameter is defaulted, the following message is 
typed at the terminal or on sysout: ; 


TAPSET-LRL IS ZERO OR NEGATIVE: DEFAULT USED, 


Note! 


In the current CMS TAP3 and TAP4’are not defined, therefore data set reference 
numbers 13 and 14 should not be used. 


Return Message: 


TAPSET-ONLY ONE ARGUMENT; CALL IGNORED, 

The tape number, tapno, and the data sect reference number, dsrn, are required 
parameters. If a call to TAPSET is made with only one argument, the routine 
returns without altering the settings for FORTRAN logical tape units. 


ty 





G2 - | AGL 


x | 11/01/68 
5G : 8 3. 7. 1. z2 
11/01/6 TRAP 
3.7.1.1-3 . 
TAPSET 3.7.1.2 TRAP Routine ws 7 
- Error Exits: (program terminates) Purpose: 


ABEND 1 TAPSET-INVALID TAPE NUMBER; TERMINATING, 


Only tape numbers 1-4 are lezal parameters The TRAP subroutine scts a user's return for an external interrupt. This return 


overrides the cz] to DEBUG on an external irterrupt. 


ABEND 2 TAPSET-DSRN IS GREATER THAN 14; TERMINATING, . 
; Calling Sequence: 
ABEND 3 TAPSET-DSRN OF ZERO IS ILLEGAL; TERMINATING, a) CALL TRAP (extrap) 


ABEND 4 TAPSET-MODESET CODE IS GREATER THAN 15; TERMINATING, 


Only the modeset codes from 1 to 15 are legal where extrap is the name of an external routine which will be transferred © 


‘to on an external interrupt. 


ABEND 5 ‘TAPSET-RECFM CODE IS GREATER THAN 5; TERMINATING, 


Only the record format type numbers from 1 to 5 are Icgal. By CALE FRAP AD) 


ABEND 6 TAPSET-DSRN5 6 AND 7 ARE ILLEGAL FOR TAPE UNITS If the argument to TRAP is Zero, the external interrupt return will be 
tae : LP, _ resect to go to DEBUG. 


Usage: 


The interrupt routine should sct a flag which should be examined by the main 
; . linc program. After the flag is set, the interrupt routine should issue a RETURN 
( , to return to the executing program. The main line program should periodically 
t 7 : examine the trap flag to determine whether an external interrupt has occurred. 


. : Example: 


The following sample program illustrates the use of the TRAP procedure using 
a FORTRAN pseudo sense switch as the flag for communicating between the 


‘ interrupt routine and the main line program, 
. s j EXTERNAL EXTRAP. 
; CALI. TRAP (EXTRAP) © , fortran testtrap 
CALL SLITE (0) T=2, 23 15:26:58 
DO 10 K=1,10000 
‘7 ; CALL SLITET(2,1) $ testtrap 
. IF (1, EQ.1) GOTO 20 ' EXECUTION BEGINS... 
A » IF (I. NE.2) GOTO 30 50 TIMES 
IF (MOD(K, 50) .EQ 0) WRITE (6,100)K 100 TIMES © 
10 CONTINUE 150 TIMES 
20 WRITE (6, 200) 200 TIMES 
STOP 250 TIMES 
: : 30 WRITE (6,300) 300 TI" 
é : = STOP e 
100 FORMAT(1X,115', TIMES'), END OF RUN 
200 FORMAT(' END OF RUN ') 1HC0021 STOP en) 
300 FORMAT(! SENSE LITE ERROR’) 
END 
\ aa - —- > 4 SUBROUTINE EXTRAP 
7 CALL SLITE(2) 
RETURN 
' END 
° : , , . a 
7 7 
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3.7.1.3 BLIP Routine 


Purpose: 


The BLIP subroutine causes a string of from one to eight characters to be typed 
on the console periodically during CMS operation. The BLIP characters ere 
typed out after every. two seconds of CPU execution and give the user an 
indication of the exccution time of his program, 


Calling Sequence: 
a) CALL BLIP ('character', count) 


the count Parameter must be an panteeee from 1 to 8 indicating the nvu:iler 
of BLIP characters. 


b) CALL BLIP ('c')’ 
}f the count is defaulted, a count of lis assumed, 


c) CALL BLIP (0) 


i the first parameter is a zero, the BLIP characters are reset to their 
non-printing default setting (a space followed by a backspace). 


Usage: 2 


The default setting of the BLIP characters is a sequence of non -printing characters, 
If it is desired to have a printed recording of the execution of a program, the BLIP 


characters should be changed to printing characters, e.g., a single dot. 
Error Returns: | 


None. 


LS 
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3.7.1.4. LOGDSK Routine | e | | Adel 


%e 


Purpose? : var 


The LOGDSK suvroutine closes all open files and writes the file directory onto 
the permanent disk, 


Calling’ Sequence: 
CALL LOGDSK 


: Usage: 


The user should call LOGDSK during the execution of his program if he wants 
to cause new or modified files to be permanently written onto the permanent 
disk before the completion of the program and the return to the CMS command 
environment. 


Error Exit: 


If the directory cannot be written out, the virtual machine is put in disabled 
wait state and control will be passed to CP, 


et 


Vea, 
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3.7.1.5 REREAD Routine 


Purpose: 


The REREAD subroutine provides a facility for rereading a record with diferent 
format statements without performing any input/output operations. 


‘Calling Sequence: 
CALL REREAD (dsrn, <blksize> ) 


where: : 
dsrn is any data set reference number from 1-99 except unit 5, 6, 
or 7 and, we 
blksize specifies the blocksize for the reread record. If the 
blocksize is omitted, it is defaulted to 140 bytes. 
Usage: 


A call to REREAD is made when it is desired to specify a reread unit or to change 


{ the data set reference number orthe blocksize. To reada record from the 


reread unit a second or subsequent time, a REWIND n or BACKSPACE n statement 


must be exccuted before the READ statement; if a subscquent reread is issued 


without executing a REWIND or BACKSPACE statement, an END OF FILE condition 
will result. Any input/output statements can be issued between a write and a read 


on the reread unit, 


. 


» 


Error Returns: 


None. 


Ey 
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3.7.1.6 DEFINE Routine — YGy 
Purpose: 
The DEFINE subroutine defines Fortran disk files that may be accessed 


randomly and makes a correspondence between a CMS file and a Fortran 
logical unit number. 


Calling Sequence: 
CALL DEFINE (dsrn, name, type, recno, recsiz, ¢&n> ) 








where: 

dsrn  . is the Fortran data set reference number to be associated 
with the defined CMS file. This parameter must be a 4 byte 
integer or integer variable. 

name is the filename of the CMS file and it must be 8 bytes in length. 

type is the filetype of the CMS file and it must be 8 bytes in length. 

" recno must be a 4 byte integer variable. Each file defined should 

use a different variable for recno. -This parameter will 
indicate which record of the file is to be read or written. 

recsiz a 4 byte integer or integer variable that contains the record 
length. All records must be the same length. If the file 
already exists, the value of this parameter will be reset by 
the DEFINE routine. 

&n * is a statement number specifying a non-standard return. This 


return is taken if the file does not exist. 


All parameters except the non-standard return are required, 


Usage: . 


DEFINE is used to make a correspondence between a CMS file and a Fortran 
* data set reference number, such that the identifiers FILE FTxxFyyy are not 
required for Fortran disk file reads and writes. Records may then be read or 
written using a standard FORTRAN statement. Records can be accessed cither 
sequentially or randomly using the sequential I/O statements. Before each READ 
or WRITE statement the record number must be set to the record desired. 
After the execution of the READ or WRITE statement the record number is ; 
automatically incremented to point to the next record in the file. Thus to READ 
or WRITE a file sequentially, the variable for recno must be initially set to 
1 before any READ or WRITE statement is executed. All control operations 
are ignored; however, reseting the variable for reeno to 1 is equivalent to re- 
_winding the file, and setting the variable for recno to recnot! is equivalent to 
skipping one record. . 


Records may be read and written without closing the file. Thus updating in-place 
is easily accomplished. , 
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SIL 
Notes: 


a. The user should remember that each READ or WRITE statement-incre- 
ments the record numbcr by at least 1. If the format statement indicates 
several records to be read or written, the record number will be 
incremented accordingly. , ; 


b. Unformatted READ or WRITE statements may read or write only one 
record per statement. 


Cc. Each different file should use a different variable for recno. 


d, A second call to DEFINE with the same dsrn will undefine the old dataset 
‘and associate the dsrxrn with the new dataset. ; 


e. A maximurn of 20 files may be defined for random access. 


Error Messages from the CALL to DEFINE: 


ILLEGAL DSRN SPECIFIED FOR DEFINE 
This means that dsrn is specified as 0, 5, 6, 7, or greater than 99, 


ILLEGAL PARAMETER FOR DEFINE 


This means that name or type was not specified or the first byte of this 
filename is X'00', 


TOO MANY DEFINE FILES 
Maximum number of different files is 20. 


DATASET DOES NOT HAVE FIXED LENGTH RECORDS 


Errors During Program Execution: 


DIRECT ACCESS RECORD NO, =0 
This means that the record number variable for recno was set to zero. 


FATAL ERROR DURING DIRECT ACCESS READ (WRITE) 
A fatal disk error occurred during the reading or writing of a defined file 
and no ERR exit was specificd in the user's program. 


EOF DURING DIRECT ACCESS READ 
The record pointer variable for recno was set to a number larger than the 
number of records in the file, and no END exit was specified in the user's 
program. ; 


3.7.1.7 DSDSET Routine 
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8B 


The DSDSET subroutine enables a user to change the record format an 
logical record I-ngth for FORTRAN disk files, 


Purpose: 


CALL DSDSET (dsrn, blksize, recfm, lrecl) 
where: 
is the FORTRAN data set reference number that will be used 


to reference the specified logical unit. This number must 
be from 1 to 14 with extcption of 5, 6, and 7, 


dsrn 


is the byte count for the maximum size of the physical 
records to be read or written on the specified unit. 


blksize 


isa type number from 1 to 5 indicating the record format. 
The type numbers are: : 


rec{m 


1) fixed record size, unblocked 

2) fixed record size, blocked 

3) variable record size, unblocked 

4) variable record size, blocked 

5) undefined record size, no blocking 
lrecl is the byte count of-the logical record to be read or written. 
+ It is used for record format types 1 through 4, For type 2 
records, blksize must be an integral multiple of lrecl; refer 
to the Fortran IV (G) Programmer's Guide, C28-6639, for a 
discussion of lrecel and blksize for variable type records, 


Usage: 
A call to DSDSET is made to change the default settings for data set reference 
numbers 1-14 with the exception of 5, 6, and 7. If it is not required to change 

“the association of a data set reference number with a symbolic tape unit, a call 


to DSDSET cart be made instead of a callto TAPSET, The default settings for 
FORTRAN disk files are as follows: 


Logical Record 


Data Set Block Format 
Reference Number Size ' Type - Length 
} 80 i 80 
2 80 1 80 
3 80 1 80 
4 80 1 80 
8 133 1 133 
9 80 1 ' 80 
10 80 1 80 


Via 
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The default settings for FORTRAN logical units 5, 6, and 7 cannot be 
‘changed. Logical-unit 5 is the sysin device to read from the terminal 
and logical unit 4 is the sysout device to write on the terminal. The 
defaults settings are as follow: 


Data Set Block Format 


Logical Record 
Reference Number Size Type a * Length 
5 80 oe 80 
6 ‘ 130 1 130 
7 : 80 


1 : 80 


Lid 
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3.7.1.8 GETPAR Routine hes 


Purpose: 


The GETPAR ebroutine obtains the parame‘2rs specified when the 
command or program was called from'CMS, 


Calling Sequence: : 
CALL GETPAR (name, number [. 'RITE! ] [) &last }) 


where: 


name is the variable (real*8) that is to take the value of the 
paramcter indicated by the argument "number", 


number is the parameter number (integer*4) in the initial 
parameter list of the parameter desired; it may be 
any non-negative value, with @ indicating the command 
or program name on initial entry. If number exceeds 
the number of parameters in the string, no parameter 
is passed, and control will pass to staterment last’ if 
&last is specified, 


'RITE' is an optional literal which causes the current parameter 
to be right-justified in its double-word field, with leading 
blanks supplied. This is useful in reading numeric para- 
meters. ; , 


&last is an optional statement label to'which control is passed 
. “if "number" exceeds the number of parameters specified. 


If GETPAR is called with item number cqual 0, the command name or pro- 
gram entry will be returned. If the error return is not specified and the 
parameter corresponding to the itern number was not specified, the routine 
will return without storing any parameter. Note that blanks-are not re- 
‘turned for an unspecified parameter, 


Example: 
1, CALL GETPAR (PARAM (1), I, & 100) 


Parameter I will be stored in the array PARAM if it was specified; 
otherwise, control will pass to statement 100, 
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3.7.1.9 CPNMON/CPNMOF Routines 


Purpose: 


The CPNMON/CPNMOF subroutines allow a ser to input variables to a 
FORTRAN program in a free format mode witout specifying the vari- 
able names as is required with the normal NAMELIST feature of FORTRAN. 


Calling Sequence: 


CALI, CPNMON 
to set the namelist feature to the free format mode. 


CALL CPNMOF 
to set the namelist feature to the Aoyendl FORTRAN mode, 


Usage: 


Under the norrnal namelist mode, the variable narne and an equal sign must be 
specified with, the valuc for each variable. In addition, the name of the list 
preceded by an ampersand (&) must be specified before the values for the 
variables are specified and the terminating marker &END must be specified 
after the values for the variables are specified. Sce Figure 3.7.1.9-A, 


Under the free format namelist mode, cach variable is specified in the 
same order as indicated in the namclist statement where each variable | 
is delimited by a cornma or atab. Sce Figure 3.7.1.9- 

To use this namelist feature, the routine CPNMON must be bone: This 
causes the free format mode to be in effect. Read and write statements 
are then issued in the standard way. 


To return to the normal mode, a call to CPNMOF should be made. Thus, 
one can go from one to the other as desired. : 


Examples: 


1. &name az=l., b=2., c=3. 
' &end 


Data specified under the standard namelist mode, 
2. 1. ry 2. ? 3. 


Data specified under the free format namelist mode. 


R;T=0. 28 


._ = «Abit 
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printf normal fortran % 72 


REAVUAA 
INTEGER B ey 
DIMENSICN C(3) 
NAMELIST /LIST1/A, B, G 
_ READ (5, LIST) 

WRITE (6, LIST1) 

STOP . 
END 


R; T=0.05 : 


$ normal 


EXICUTION BEGINS,.. 2 
&listl r 

=p 

‘b=2., Cc 33, 4, » 

poe 


Rend 


&LIsTl 


A= 1,.0000000 ,B= 2,G=3.0000000 ,4,000000 , 5.0000 


“&END 


R; T=0. 32 
: FIGURE 3. T. 1. 9-A 
printf freefrm fortran * * 72 


 REAL*4A 
INTEGER B 
DIMENSION C(3) 
NAMELIST /LIST1/ A,B,C 7 
CALL CPNMON 
READ (5, LIST 1) 
WRITE (6, LIST) 
STOP 
END 

R; T= 0. 03 


$ frecfrm 
EXECUTION BEGINS... 
1,2,3,4,5 
& List) 
& END . 
4,.0000000 , 5.0000 


A=1.0000000. ,B= —.2, C=3, 0000000 _, 


FIGURE 3.7. 1.9-B 





11/13/69 


3.7.1.10-1 11/13/69 
CMS 3.7.1.10-2 
= F471 
497 MS HAMA 
3.7.1.10 CMS Routine 
REG. 15= nonnonnn 
Purpose: -The CMS subroutine enables the user to execute The contents of register 15 on return from the 


CMS command are displayed. This value corresponds 
to the E(nnnnn) received in the CMS command 
environment. 


‘CMS commands from within a Fortran program. 


Calling sequence: 


CALL CMS (command, arg 1, arg 2, arg 3,...,arg N, <, &n>) Note: The arguments in the calling sequence must be 
either 8-byte literals enclosed in quotes ('), 
where: command is the CMS command name and it must be or REAL*8 variables. 
8 bytes in length 
Examples: 
arg l,...,arg N are the arguments for the CMS 
command (as many as required) 1. CALL CMS ('ALTER ', ‘SORTDAT ', 'DATAFILE', 
Each must be 8 bytes in length. ‘Pl ', ‘FILE ', 'FITO3FOOL', 'P1L ‘) 
&n Where n is the (optional) error 
return statement number 2.  REAL*8 TXEQ,MINS,SECS 
DATA TXEQ/'TIMELIM '/,MINS/'25 '/,SECS/ '30 "/ 


"CMS" is used to allow Fortran programs to execute CALL CMS (TXEQ,MINS ,SECS) 
CMS commands. The number of arguments required in CALL EXIT 

the CMS subroutine call is determined by the END 

particular CMS command being executed. 


Usage: 


Some suggestions can be made concerning the 
types of applications which are particularly 
useful. One is to alter a data file's name 
and type during Fortran execution to a file 
recognizable by Fortran, i.e., FILE FIxxFyyy. 
Another is to set a time limit for execution 
(TINELIM) within the program to be timed. A 
user may wish to enter the DEBUG environment 
if unexpected conditions occur; he can do this 
via a call to CMS. 


Error messages: ‘ 


CMS COMMAND ERROR 
An error return has been received in attempting 
to execute a CMS command, 


COMMAND#*xxxxxxxx 
This message identifies the CMS command which 
returned an error code. 





4.0.0 CONTROL PROGRAM CONSOLE FUNCTIONS 


To communicate with the Control Program (CP) and to simulate 
the computer console, the user can issue CP console functions. These 
console functions allow the user to perform such operations as initially 
loading the desired ‘system (i.c., CMS), dumping core selectively, closing 
out files on unit record devices, displaying core and machine conditions, 
communicating with the operator in the computer room as well as with other 
users, controlling messages typed on his terminal, and beginning program 
execution at a certain core location, The user also has the ability to simulate 
the Systern/360 console system resct key, simulate the console interval timer 
switch, cause the Control Program to simulate an externa] interrupt, replace 
specified parts of core, ready specified I/O devices, and release the virtual 
machine, Additional 1/O devices can also be added to a specific virtual machine 
and then be released for use by another virtual machine. 


The Control Program environment is entered on the completion of the 
login procedure (sce Section.2.2.2). After the message "READY AT xx:xx:xx 
ON xx/xx/xx", is typed at the user's terminal where xx:xx:xx is the time of day 
and xx/xx/xx is the date, the keyboard is unlocked and the Control Program is 
then ready to accept console functions. By typing "IPL CMS" or "IPT, 190", 


the user loads the Cambridge Monitor System and he can begin issuing CMS 
commands, 


To re-enter the Control Program from CMS, the user must hit the ATTN 
key once, This causes the keyboard to unlock and permits the Control Program 
to accept console functions. If the ATTN key is hit again while in the Control 
Program, the keyboard will unlock for an input line to be entered, suchas a 
CMS command or a line of data for the program being loaded and executed; control 
will then be transferred to the environment from which the control program was 
entered, For instance, if the CMS command "ASSEMBLE LOOPX"” had been 
issued and then the ATTN key was hit twice and "PRINTF LOOPX LISTING" 
entered, the assembly would continue and as soon as it terminated, the LISTING 
file would be typed out. If there is no desire to enter an input line once the key- 
board has unlocked, hit carriage return and then control will be transferred, as 
above, to the environment from which the Control Program was entered. The 
console function BEGIN is also used to leave the Contro}) Program; it causes 
control to transfer either to the environment from which CP was entered or toa 


specific core location, if one is specified. Details for using BEGIN are discussed 
in Section 4. 1.1. 
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4.1.C Console Function Lescriptions _2 4.2 7 


ce console functions are issued in the Control Progranp 
envircnment. Irput can be entered in either upper or lower case. 


Entering input in lower case enable the user to distinguish the input 
freu the cutput, since all output will be typed in upper case. 


Contre] fErogram has a character delete syphol anda line 
Pantry toth of which are the same as the default characters in 
CHS. The at character (2) deletes the imnediately preceding character 
from the input Jine and itself. It may be used repetitively to delete 
a string of characters. The cent Character {f) or shift K (left 
bracket) cn the teletypes, deletes all preceding characters in the 
line and itself. A character delete symbol (@) cannot be used to 
delete a line-delete symbol (#). Note that if the character delete and 
line delete synbcls are redefined in CHS, they are not redefined in 
Cr. : 


e 


One or more blanks must be ‘used to delimit operands or arguments 
specified with the censcle functicns. 


ole functicn is accepted. and executed if a carriage return 
scale Sf tie keyboard is unlocked unless the console function caused 
contrel to pags to ancther envircnment, in which case the response 
yill be that cf the new environnent. If a console functicn 
rejected, the message “INVALID CE REQUEST" is typed out. 1eaneel* 
cperands ate efecified with a console function, the message "BAD 
ARCUMENT xx" is typed cut where xx 1s the argument nunber. If enly 
cne Opetand is specified and it is invlaid, the console function is 
not executed. If multiple operands are specified and part cf then are 
invalid, the valid cperands specified befcre the first invalid operand 
hill be executed properly. If a null line is entered to CP, i.@. 4 
carriage return with ne frevicus characters in the line, the 
ccenfitring message "CP" is typed. 


Y 


The conscle functicns that are available for the user are listed 
kelcws 
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CUNME 
EXTERNAL 
IFL 
LOGOUT 
MSG 
PURGE 
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; 4¥.1.-0-2 F . 05/01/69 
REALY 4.1.11 be ieee he eee ce | 
RESET 4.1.12 Soe Lip Cre 
SET ; or oo) 4.1.1 EEGIN fi 
SLEEE 4.1.17 . — 

SECCE : 4.7.18 7 S2/ 
STORE 4.1.13 EVrLEOse: 

XFEER 4.1.15 


BEGIN initiates execution at either a specified core lecation of 
at the leceticn specified in the current PSW (which is normally 
the lecaticn from which the Contro) Program was last entered). 


Ecrmat: 
1 BEGIN { <hexloc> { 
J E I | 
bexloc is the hexadecirzal cere lccation 
; at which execution is' to hegin. 
Usags: ‘ 
BEGIN trarsfers centrcl te the specified hexadecimal core 


locations If a hexadecimal core location is hot specified, 
exccuticn will resume’ trem the Ilccaticn ccntained in the current 
Frcegram status word (PSH) - this is normally from the location at 
which the Centre] Pregram was last entered, unless the PS® was 
: Freviously changed. For example, if the Console Prograt had been 
‘ : : 7 ; entered frem CUS by hitting the ATIN key and BEGIN is issved 
; without ‘specifying a ccre lcecation, CHS is entered at the 
locaticn from which it was left. 


BAC ARGUNENT. xx 
, - Ap invalid hexadecimal core location was specified in argument 
number xx. Correct the request and issue again. 


Any other tcesponse will ke that of the new environnent. 


Exaegles: 


{ 7 a 28 
7 . ; Execution resumes at the location from which CP was last entered. 


‘ be B 15C€CC 


Control is transferred to hexadecinal core location 15000. 





; oe ; -7- 19268 bia - 423.68 
a ; ade 2tl SOD) | AAQ-2 
: CLOSE | euase 727 
ae a 
4.1.2 CLOSE, a Notes: . 
. i Phy Aare ee © rs , , a. ‘CLOSE 00E" must be given after the DUMP console function has been 
Purpose: issued, 
CLOSE veloases tha spooling Sede trom the specified multiplexor b. Logging out from CP will automatically issue a CLOSE for the virtual 
devices, and the actual I/O operation is performed for any output. card reader, printer, and punch and release all spooling areas. 
Format: ; . . 
permeeecaces : Responses: 
i BAD ARGUMENT. 
Pe decaid An invalid device was specified. 
a ' t 
, Examples: 
: a. cE ae | = 
The spooling area for the virtual printer {s printed and released. 
devadd is the device address of the virtual card reader, . 
card punch, and printer, which are normally 00C, 
00D, and OOF, respectively, for CMS. 
Usage; 


In releasing the spooling areas for the virtual card punch or printer, CLOSE | 
punches or prints the contents of the spooling area on the real device when that 
device; becomes available. The printed output is preceded by one page containing 
the user's identification, the date and the time of day in the following format: 


a q OF ELSA E 
: _. Ustv2D 07/25/69 i 
CP4USE RID AGN? abated Pict . 
The punched output is preceded by one card containing the user's identification, : 
the date, and the time of day, in the following format: 
columns 1 - 10 ClO7USERID 
columns 13 - 20 uscr's id, left justificd 
columns 25 - 32 date (mm/dd/yy) 
columns 37 - 44 time (hh. mm. ss) 
columns 49 - 80 asterisks (*) 
This punched ID card is in the correct format to be used as the input identification 
card required by OFFLINE READ (see Section 3.1. 11). 
In releasing the spooling area for the virtual card feader, CLOSE ~— 7 . 


assumes that the user has read all the cards he wants from the current 

ecard deck and frees the spooling area, If another command to read a 

card is then executed, CP will return either the first card of the next : a 
deck it has read for that user (if any), or reader-not-ready. . © 


9-17-67 . 9-17-67 


ae 4.1.4-1 
4.1. 3-] f 
petacn 52% piseLay S45" 
4.1.3 DETACH 4.1.4 DISPLAY 
Purpose: Purpose; ; 
DETACH removes the attached device whose address is specified from the _ DISPLAY types out in hexadecimal the contents of the virtual penis s ee 
virtual machine configuration. storage, gencral purpose registers, floating point registers, and/or progr 
status word. 
Format; 
Format: 
(CoSerie ie Saas ae Pg te Be Tee ee Sale i —— 
t N ‘ eee Teel Sere te elt heehee he oth eh ee alae cei taatts ' 
: 3 DETACH‘! — devaddr itera nieion : ; 
’ ~ DE vt ' : r # fhexloc] [hexlocl-hexloc uhexloc ‘ 
Br gn NT SRM he aieiain eames eae aaa , p. eISEEy 1 [Lhexlocl -hexloc2] [Greg] [Gregl-reg2] * 
we : ' n D : [Yreg] [Yregl-reg2} [PSW] - a! ‘ 
devaddr specifies the address of a device that had previously ! : : 
; been attached to the virtual machine. Seenimea tr ataehaceus teats peekgesae sates retake es ees tmaeaes 
Usage: , hexloc is interpreted the same as Lhexloc. 
DETACH is used in conjunction with the console function ATTACH, which can Neeser nedoes is interpreted the same as Lhexloc1-hexloc2. 
only be issued by the CP operator. Once a device has becn attached to a virtual : : - 
machine (see Section 4.2.0 for a discussion of attaching I/O devices), the = . 
responsibility is left to the user to remove or detach the specified device from cheeine displays in hexadecimal the contents of the specified 
his configuration. As long as the device is attached to him, it is unavailable hexadecimal location hexloc. 
for use by any other user. 
: - -hexloc2 displays in hexadecimal the contents of the specified 
DETACH removes the specified device address from the configuration. As soon. : y i hexipe lr hexlec ree al locations hexloc1 through hexloc2. 
as the device is detachcd, the message "DEV devadd DETACHED! is typed out : 
at the tcrminal and the device is free for usc by other users. Also, a message : ; Grex displays in hexadecimal the contents of the general 
is automatically typed out to the CP operator Specifying the device that is free. ; purpose register reg, where reg is an integer rang- 
If the device address detached is that of a tape drive, the tape will be rewound . 3 ing from 0 to 15. 
and unloaded. ° : , 
Responses: 


Gregl-reg2 displays in hexadecimal the contents of general pur- 
' pose registers regi through reg2, where reg! must 
be less than reg2 and each reg must be an integer 
ranging from 0 to 15, 


BAD ARGUMENT. 
An invalid argument was specified. 


DEV devadd DETACHED. . ts, | . . 

The specified device address is no longer usable. The device must be attached Yreg displays the contents of the floating point register 
again for further use. reg, where reg is an integer ranging from 0 to 7. 
. If reg is odd, it will be adjusted to the preceding 


NONEXISTENT UNIT even integer. The contents are displayed in hexa- 
The specified unit does not exist in the virtual machine configuration. It has cither decimal in two forms: the internal format and in 
been detached or it was never attached. ; the E format. 
P Examples: 
ff a. DETACH 181 
: console function: detach 181 
! . response: DEV 181 DETACHED 


Unit 181 is detached from the virtual machine configuration. 





o 








9-17-67 
4.1.4-2 5. 
DISPLAY S06 


Yregl-reg? displays the contents of the floating paint registers 
regi through reg2, where reg1 must be less than 
reg2 and cach reg must be an integer ranging from 
Oto 7, If reg and/or reg2 is an odd integer, cach 
Will be adjusted to the preceding even integer, The 
contents are displayed in hexadecimal in two forms! 
the internal format and the E format. 
PSW displays as two hexadecimal words the contents of: 
the program status word (PSW). 


Usage: 


Before the specified contents of core storage is displayed, alignment is made 
to the nearest full word boundary. The outjtut is typed in multiples of a full 
word (8 hexadecimal characters) and all information is displayed in hexadecimal, 


When DISPLAY is issucd, the arguments can be combined in any order desired, 
* separated by one or more blanks, up to one input line in length. If neither G, 
’Y, nor L precedes the specified number, Lis assumed. If an invalid argument 
is specified, a message is typed out and the console function terminates. If 
any valid argifments were specified before the invalid one, they will be executed 
properly. 
Notes: 


a. The contents of core, the registers, and the PSW are not altered by 
issuing DISPLAY. 


b. No imbedded blanks are permitted within an argument. 


Responses: 
The specified information is typed out. 
BAD ARGUMENT. 


An invalid argument was specificd. If valid arguments were specified before 
the first invalid onc, they were executed properly. 


Examples: 


a. disntay 112n93 
tL 12600 = 9208F17£ 


The core storage location 12403 is adjusted to the nearest full word boundary 
12400 and one full word is displayed in hexadecimal 


9-47-67 
4,1.4-3 . 
DISPLAY S07 


b. “display 12000-12010 ae 
-t 12000 = OSCOSOED C7EES830 8065833 00385030 cCROF1821 


The contents of hexadecimal location 12000 through 12010 is displayed 
in hexadecimal in multiples of full words. 


c dAlsplay «1 
6 1 = 00011098 


The contents of general purpose register 1 is displayed in hexadecimal. 


da. d 21-5 
q 1 = 00011C98 00008990 GN008340 00000082 00000400 


The contents of gencral purpose registers 1 through 5 is displayed in 
hexadecimal. 


e. d y2 

Y 2 = 000n560000N00000 214627299E06232350 F-78 
The contents of floating point register 2 is displayed in hexadecimal in two 
forms: the internal format and the E format. 


f. 4 v1-6 
Y NM = 1230N0000000000NN © 76468411734357709 E-56 
Y 2 = 00045A0000000000 2149627299646232350 E-78 
Y h = ONOONNAS1110000N »88057543H52313567 E82 
Y fi = 0N9999999999N0NN ©51817911330519540 E-77 


The contents of floating point registers 0, 2, 4, 6 are displayed in 
hexadecimal in hwo forms: the internal format and E format, after 
the specified register 1 is adjusted to the preceding even integer 0. 
g td oosw 

PSY = NCNNNAIN 80001374 


’ The contents of the program status word (PSW) is displayed in hexadecimal. 


h. ‘d pl-b ce 591 yh psw 


G = 00011098 ngo0gegay NOOOR THO 0N00008? ; 
L Kb = ANOLICAD aconnonn AHOIILGD FFEPEEFF TOPEACCE 
Y ho & NNNNKCORKANANNANNN NaNHNNnADeIONNNNND F CO 

PSV = QONNPHND £000137h 


The contents of general purpose registers 1 through 4, hexadecimal locations 
40 through 50,. floating point register 4, and the program status word are 
displayed in hexadecimal with one console function. 


, 4.1.5-1 ee 9-17-67 
1. e RG 4.1.5-2°- 
pump SCs 507 “5 
eats pump °° a 
4 
4.1.5 DUMP . 
Usage: 
Purpose: . Before the specified contents of core storage is dumped, alignment is made to 


the nearest full word boundary. The output is printed in multiples of a full word 


rints: leci th inter the contents of core stora ; ; as ; ; 
DUMP prints-in hexadecimal on the virtual print Es (8 hexadecimal characters) and all information is dumped in hexadecimal. 


general purpose registers, floating point registers, and/or the program status 


word. DUMP prints the specified information on the virtual printer. In order for CP 
Hosiiat to close the virtual printer (to release the spooling area) and print the dumped 


information on the real printer, the console function "CLOSE 00k" must be 
issucd. CLOSE need only be issued once for the printer after all the variations 
of DUMP have been given. 


FN HH rR MO eo eo 


i] 
(] 
DUMP t — [hexloc] [hexlocl-hexloc2} [ Lhexloc] 
} [ Lhexlocl-hexloc2} [Greg] [Gregl-reg2] 


een ewe eee 


DU Yre Yregl-reg2] [| PSW] Ba When DUMP is issucd, the arguments can be combined in any order desired, 
[ g] [¥x B 8 ; separatcd by one or more blanks, up to one input linc in length. If an invalid 
ey ty ge ee eet ne anaes Gr ee ORR oe eal Se arguinent is specified, a message is typed out and the console function termin- 
hexloc is interpreted the same as Lhexloc ates. Jf any valid arguments were specified before the invalid one, they will 
be executed properly. 
hexloc1 -hexloc2 is interpreted the same as Lhexloc4-hexloc2. ei 
otes: 
Lhexloc dumps in hexadecimal the contents of the hexa- 
Sonica location hexloc a. The contents of core storage, the registers, and the PSW are not altered 
, by issuing any form of DUMP. 
i Lhexloc] -hexloc2 dumps in hexadecimal the contents of the hexa- 


decimal locations hexloc4 through hexloc? b. No imbedded blanks are permitted within an argument. 
> G .4 & : G FS & x ae 


Greg dumps in hexadecimal the contents of the general sco onses 
purpose register reg, where reg is an integer rang- 

ing from 2 to 45. _ 
Z . BAD ARGUMENT. | 


. 


After the completion of valid DUMP console functions, the keyboard is unlocked. 


Gregl-reg2 dumps in hexadecimal the contents of the general An invalid argument was specificd. If valid arguments were specified before 
: purpose registers regi through reg2, where rey4 the invalid one, they were executed properly. 
must be less than reg2 and each reg must be an 
integer ranging from 0 to 15. Example: 
Yreg _ dumps the contents of the floating point register es sunpxkinte ‘ 
reg, where reg is an integer ranging from 0 to 7. ‘dump y0-G 
If reg is odd, it will be adjusted to the preceding 
i even integer. The contents are dumped in hexa- dump 0-80 
decimal in two forms: the internal format and the 
E format. dump psw 
Yregl-reg2 dumps the contents of the floating point registers oe . 
regi through reg2, where regi must be less than General purpose registers 1-15, floating point registers 0, 2, 4, and 6, core 
reg2 and each reg must be an integer ranging from storage locations 0-80, and the program status word are dumped on the virtual 
Oto 7. If reg4 and/or reg2 is an odd integer, each printer. To close the virtual printer and print on the real device, "C E" was ae 
will be adjusted to the preceding even integer. The issucd. The dump output is shown in FIGURE 4. 1.5-A. aa 
: contents are dumped in hexadecimal in two forms: : 
the internal format and the E format. 
PSW , dumps as two hexadecimal words the contents of the 


program status word (PSW). 
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‘Output from DUMP console functions. . 


FIGURE 4.1.5-A. 


ae 


Purpose: 


fsrgat: 
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4.1.6 EXTERNAL . | Ale 
/ S/ 

EXTERNAL simulates an external interrupt cn the virtual machine 
and returns ccntrol to that sachine. . 
{ | 
" EXTERNAL \ 
{ I ! 
i 1 


ee ee ee ee ee ee ee 


sags: 


On a real sachine an external interrupt is a means ty which the 
central peecessing unit responds to signals from the interrupt 
key on the computer ccnsole, EXTERNAL simulates this external 
interrupt, which is then reflected to the virtual machine, and 
control is returned tc that nachine. If the user had previously 
IPled CNS, the Debug environment of CMS will be entered from the 
Control Pregram. If the user had not IFLed CHS, the external 
interrupt sill cause the message 


CE ENTEREL, REQUEST, PLEASEe«es 


to he typeé cn the terrinal and the CP envircnment is entered. 


. 


Fesecnses: 


DEEUG ENTERED, EXTERNAL INT. 
CMS was previously IPLed. khen the external interrupt occurred, 
the Debug environment was entered. 


CE ENTERED, BEQUEST, ELEASE,. 
No operatirg system had been. previously IpLed; therefore, vhen 
the external interrupt cccurred, control vas returned to CP. 
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H#.1.7-1 
4.1.7 0 IPL . Ais 
TH 
EULEGse? 


Ip] causes the Control Program to simulate an Initial Prcgran 


Load (IPL) sequence on a specified device. 


Fetoat: 
J J I 
{ mer f{ CHS J 
! I H devadd H 
j ! a | 
is) tes ne eet tes eh Sees Se : 

CuS syecifies that a "saved" ccry 
ef the Cambridge Monitor Syster 
ig ta be breught isto core. 

Geyadd specifies the address cf the device 
tc be IPLed. 

Usage: 


IPL simulates the IPL Euttcn on the computer console by resetting 
the virtua) machine and causing a record to be read fre the 
specified 1/0 device and exectued. 


v 


During the login procedure of CP when the message 
READY AT XXeXXeXX ON XX/XX/XX 


is typed out, where xx.xx.xx is the tine cf day and xxyxx/xx is 
the date, CP is ready to accept any console function. Py issuing 
"TEL CHS® or "IPL 190", the Cambridge Mcnitor Systen 
loaded and the CMS ccorand environment is entered. 


The "IPL 790" ccnsole functicn will lcad in a copy of the nucleus 
which resides cn disk 190. Periodically, a copy of this nucleus 
is saved ty a CP utility. The "IPL CNS" console function will 
load in this "saved" copy cf the CHS nucleus. This means that if 
the nucleus on 190 has been modified since the last copy was 
saved, the versicns referenced by "IPL 190" and "IPL CMS" will be 
different. , 


B€sponses: | oO ; ; ; 





(CMS) is 
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uO1L7-2 
os 7d . 
DSF BY 
7) S79 
_ BAD AEGUMENT xx 
An invalid device address was specified. 
ERLKCR CURING IPL SIO. . 
CP is unakle to load from the specified device. If the cara 


reader had teen specified, check tc see that cards had been read 
intc the virtual card reader by the conputer operator. 


UNABLE TC TEL SFECIFIEL UNIT TYPE. 
The specified unit cculd oct be IPlLed. 
specified device address is included 
configuraticn. 


Check to see if the 
in the virtual machine 


Any cther responses are these cf the new environment that is 
beirg Jcaded. 
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4.1.8 LOGOUT ; | Ai. 
SY 
EXEPOse: 


Ysage 


LOGCUT remcves the user frem the system by relcasing the virtual 
pachine and any attached devices, clearing the temporary disk 
area, and clesing the specling areas. 


nm 
=) 
s 
“< 
oe 
wa 
a 
s 
ms) 
Vv 
— a0 ae oe 


anything If any nen-blank character string 
is specified with LOGOUT, the 
telerhene line is not hung uf and 
_ the terminal remains connected to 
CP for ancther user to legin or "dial" in. 


LOGOUT? loce the user cff.the system. The’ temporary disk area is 
cleared and all spcoling areas are closed. If there is cutput in 
the spocling areas, it will be printed or punched ona real 
device wher that device becones available, as in CLOSE. 


Because of the finality of this command, the oanly abtreviation 
accepted js "LCG", 


- 


If *HCLD' is specified, a ICGOUT occurs in the normal] tranner but 
the cormunicaticn line is net disabled. Upcen completion of the 
LOGCUT procedure the 'CP/67 online'® message will indicate that 
another ‘*icgint cr *dial' can procede. 


fesronses: 


LCGCUT AT xXx.xxXexx ON XK/XX/XX . 
The user is removed from the system. The xx.xx.xx is the time of 
day and the xx/xx/xx is the date. 


CE-67 CHLINE xxxxxxxxxxxx 
/ XXXXXAXEXXXX CP-67 CNLINE 
_CP-67 ONLINE If one of the above messages is typed out after 
the LOGCUIT message, a non-blank character string .was specified 


With LOGOUT; 
another user. 


therefore 


the terminal remains connected 


05/01/63 
4,1,8-~2 
to CP for 


SUS Fee 
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s 4.1.9-1 : . 4.1.9-2 
eee ; Lig 
4.1.5 ESG AY ; 2 Jor 

: . S . ' USER tCT GN SYSTEH 
EULECSe: the specified user was not logged on the system so the message 


was not sert tc hip. 


4SG sends 8 specified message to either a specific user or to all 
users. Exanrje: 


Format: a | : a. msg CE please attach a tape drive to 181 


lhe wessage "please attach a tape drive to 181" is typed out at 
See Ce ge ae the systems operatcr's tervinal. 


userid line] 
CP } 


—_ = a 
=x 
wn 
oO 
ee ay 


~_ —_ meee ee 


userid specifies to whom the message should 
cP be sent. If 'CP* is specified, the 
message is sent.to the systems operator 
whatever his userid sight be. For this 
reason no user should have the id of 
*CP*; CPxxxxux is acceptable thcugh. 


line | iz the message to be sent to the 
specified user cr users. 


. . = . ad 


MSG allows the users to communicate with the CP operator in the : 

ccmputer rcon as well age with cther users. The specified user . 
gust be lcgged on the system before a message can be sent to him. 

If a specified user is not legged on, the ressage "USER NOT ON 

SYSTEM" is typed out and the message is not held until he logs 

cn. ; 


A message that is sent by MSG is in this format: 
FRCM userid: line 
The messace will be typed cut at the specified user's tersinal . ' 
then the terminal is not ready for input. If the terminal is . 


waiting fcr input, the eessage will be held until a carriage 
return ‘occurs. 


_ Besponses: 


userid WOT RECEIVING 
The user hes suppressed his receiving of messages. 
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ree #.1.10-1 
ats CLERY : 
46 
SIE 


Eurpose: 


CUERY types out either the number of users logged on or @ialing, 
the jdentiticaticn and tersinal address of the users logged on, 
the gaximun number of users allowed to lcg on the systen, the log 
bessages set by the CP cperatcr, the maximum size of the console 
dispatching queve, and the number of spooled input and output 
files currently held by CP for the user. 


Format: + 
J f i 
i I fr 
i ft FILES I 
I | LOGMSG 1] 
ti CUERY { BAX i 
t Cc t NAMES i 
I 1 ¢2 | 
! } USER <nares> ! 
) ! USERID <userid> |} 
I 1 ! 
FILES types the number of spooled input and 
¥ output files currently held by CP for 
the user. : 
ICGMSG types out the message of the day set 
L ty the operatcr. 
MAX types out the maximue number cf users 
¥ that the operator allows to 1cg on to 
Ce. If it is zerc, ne naximum number 
has been set. 
NAMES types out the userid and terminal 
N address of all users cn CP. 
¢2 types the raxinun size of the ccnsole 
¢ dispatching queue, 
USER types out the numher of tyirtual machine? 


users and the nunker of users attached to 


‘This is the response tc "Q 


. this is the response to "Q 


05/01/69 
4#.1.10-2 
virtual machines using the CP~67 DIAL 
capacity. ‘ GA 
S/F 
USER’ NABES 


sane function as CUERY names. 


USER userid 
fame aS QUERY userid, 
types out the userid and the terminal 


address where he is legged in, cr 
gives "USER NCT CN SYSTEM*. 


userid 


CU ERY is used to determine the number cf users leqged on or 
dialing, wko they are, and what their terminal address is, haw 
many are ajlowed to log cn, what the log messaqe is, the size of 


the interactive dispatching queue, and the number of current 
spooled files fer this user. This information gives an idea of 
the system load as well as any pertinent information about the 


system. The lcq message is ncermally the message 


that types out 
cnce the tser has logged on under CP. An 


BAD AFGUMENT. xx 
An invalid argument was specified. 


. 


nn USEKS; 


LIALEL argument was specified, 


If the USER nn this sessage 
indicates that nn users are either Icgged in or "dialed in", 
tespectively. If the MAX argument was specified, this nessage 
indicates the maxinur number of users allowed to log on to CP, 


(only nn USERS printed}. 


userid — xxx, userid ~- xxx 2. « « 
If the NAMES argument was specified, current users are displayed,’ 
four tec a line. : : : 


userid - xxx 
userid" if that user is logged on. 


USER NOT ON SYSTEM 
userid" if that user is nat lceqged cn 
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4.1.10~-3 
tc C P-67 . Z . 
ji bLleren ; 


FILES: xx RDR, xx PRI, xx PCH 
lhe nurber of spooled files for this user is printed. 


MMXXN wee KXXXX ae 
This is the lcg message obtained as a result of specifying the 
LCGMSG argtment. 


Fxageles 


ae query user 
O4 USERS; 06 DIALED 


Four users are logged on the systen. 
Six users kave "DIALED* cther yirtual machines. 


kb. g names 
, HAEMCN - 024 
OEERATOR - . 009,-APL ~023, CJCHKSON -—024 
_NCEMAN - 025, RIP ~O4B 


* 


A list of current users logged on the systes is typed cut on the 
terminal. 


Ce Gg max 
00 USERS 


A naxinug mumber of users cn the systen has not been set by the 
. Ceeratce. 


d. gq lcgssq. 
TS COSN AT 12 SHARE 


When log message "TS [OWN AT 12 SKAP", set by the operator, is 
typed out. 


€. q files 
FILES: 01 BDB, 06 PRT, NO PCH 


the nusber of separate spooled files for the user is shcwn. It is 
a total for al] virtual card reader, printers or ‘punches. 


f. g terp21 
TEMP21 ON 032 


q terxp4 . 
USES KOT OW SYSTEM 





, BesEansess 
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4.1.11 zeny MEL 
, SY 


EurEcse 


REALY sinsulgtes a device end fcr the specified virtual address. 


devadd specifies a virtual device 
address, such as 191. 


Usage: 


% 
% 


Cn a veal sachine a ie end is acused by the cempletion of an 
I/G oferation at a ‘device or, on some devices, by manually 
changing the device fen the nct-ready ta ready state. A device 
end nermally indicates! that the I/O device has becose available 
for another oferaticns READY eimualtes this device end without 


‘having tc ccmplete an W0 Operation or without spaking a device 
not-ready. 4 


: \ 


bs ; 5 
\ 
2 4 
BAD AFGUMENT xx 
An invalid device address \as specified. 


\ 
7 
NONEXISTENT UNIT \ 


The specified unit dces hot exist in the -virtual machine 
configuration. 


Ex2ngles 


. 


ae REALY 191 
A device end is simulated for the device whose address is 191. 
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fe La ad : 7 | . 7 4.1.11-1 
a ; | : | . Be READY 


¢ "gap Reapy — Se x, 


. 3 Purpose: 
es READY simulates a device end for the specified virtual address. : 
ie . eo 
: -Format 
- eS = ee eee ee 
ts Cn enael a 
, f freapy} : devadd ; 
cs * a | R a a ¢ . 
— 6 eeeeeasancnmacaancd cunnnacccewansaen! 
devadd specifies a virtual device 
3 | ae _ address, suchas 191. - : 
a Usace: Fae : | 
cs . Ona real machine a device aa. is caused by the completion of an I/O operation 
es | ata device or, on some cevices, by manually chan gn ig the device from the act- 
ees ready to the ready state. ‘A device end nor mally indicates that the 1/0 device 
neo has become available for another oneretion. REA DY Simulates tus device end 
ie ¢ _ * without having to compicte an 1/O operation or without making a device not- 
: ready. 
Be Responses: | | , : 


BAD ARGUMENT. - ; : 
An invalic device address was specified. 


NONEXISTENT UNIT 
The specified unit cces not exist in the virtual machine configuration. 
; | Examples: : 


a READY 191 
A device end is simulated for the device whose address is 19]. 





os + we 


4.4.12 RESET 


Purpose: 


Format: 


ee 


RESET places the virtual machine in a stooped state and resets all pending I/O 
All error conditions are reset. The system is automaticaliy reset 


interrupts. 
by IPL. 


Response: 


*. 


Nore. 


SOO Oe Teewea eaeeenas'a 





feeceaane, 


SOSGoerweaenertoavowvaeoaar 


Lae tte 
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RESET 


RESET simulates the system reset key on the system control pancl. 


<< oe 


9-17-67 
AUN2-1 0 ALLL 
RESET_ . 


4.1.12 RESET 


Purpose; 
RESET simulates ‘the system resct key on the system control panel. 


Format: 





Usage: a . 
RESET places the virtual machine\in a stopped state and rescts all pending 1/O 
interrupts. Al] error conditions are reset. The system is automatically reset 


by IPL. 


Response: 


None.) 


4.1:13 STORE 


Purpose; 


. oR 9-17-67 
4.1.13-1 
store S13 


STORE replaces the contents of specified locations in core storage, gencral 


purpose registers, 


Format: 


ee ed 
~” 
a8 

—" 


- Lhexloc hexinfol. ..,hexinfoN 


Greg hexinfol, . ,hexinfoN 


Yreg hexinfol, . .hexinfoN 


floating point registers, and the program status word. 


ee ee ee eee ee eee 


{ Lhexloc hexinfol.., hexinfoN] 2 
{ Greg hexinfol... hexinfoN] 

[ Yreg hexinfol... hexinfoN) © 2 
[Ppsw{hexinfol] hexinfo2] “ 


ee 


stores the hexadecimal! values hexinfo1...hexinfoN 
in successive full word locations starting at hexa- 
decimal location hexloc. 


stores the hexadecimal values hexinfo1...hexinfoN 
in successive general purpose registers starting at 
the register specified by reg. The parameter reg 
must be an integer ranging from 0 to 15 and succes- 
sive values of reg cannot excecd 15. 


stores the hexadecimal values hexinfo4...hexinfoN 
in successive floating point registers starting at the 
register specified by reg. The parameter reg must 
be an integer between 0 and 6 and successive values 
of reg cannot exceed 6. If reg is an odd integer, it 


_ will be adjusted to the preceding even integer. 


PSW { hexinfol}) hexinfo2 





stores the hexadecimal values hexinfot and hexinfo2 
in the first and second words of the program status 
word. If only hexinfo2 is specified, it is stored in 
the second word of the PSW, The interrupt code is 
set to zero. The hexinfo1 and hexinfo2 must be sepa- 
rated by one or more blanks. 


Usage: 


: 9-17-67 


4.1.13-2 go 
STORE ~~ 


O 


The smallest group of hexadecimal values that can be stored is one full word and 
alignment will be made to the nearest full word boundary. If the hexadecimal 
value being stored is less than a full word (cight hexadecimal characters), it will 
be right adjusted in that word and filled in with high order zeroes. 


‘he options can be combined in any other desired, separated by one or more 
blanks, up to one full line in length and issued in a single STORE console function. 
Hither L, G, or Y must be specified or the option will be invalid. 


If invalid arguments are specified, a message is typed out and the console function 
terminates. If there are any valid arguments before the invalid one, they are 
executed properly. a 

‘ ; i e 


Response; 


BAD ARGUMENT. 
An invalid argument was specified. If there were any valid arguments before 
the invalid onc, they were executed properly. The console function terminated 
on the invalid argument. 


Examples: 
RR , Sean 


a  d@ 12011 
L 12010 = 4110p01¢ 


gt 112011 579 


d 12011 , 
t 12010 = 00000579 


“A full word at core storage location 12011 is displayed after alignment is made 
to the ncarcst full word boundary 12010. The hexadecimal number 579 is right 
justified, filled in with zerocs, and then stored in a full word beginning at 
location 12010. That word is displayed again to reflect the changed value. 


“b. d 25-8 
G 5 = 00000400 0000000¢ 0000049¢ 00000004 


st g5 123 456 aa 


d 25-8 
G 5 = 00000123 00000456 OOO0OO0AA 00000004 


The contents of gencral purpose registers 5 through 8 is displayed. The hexa- 

decimal numbers 123, 456, and AA are right justified in separate words, filled 

in with zerocs and then stored in general purpose registers 5, 6, and 7. The ° 
contents of registers 5 through 8 are then displayed to show their stored contents. ser 


‘9-17-67 
4.1.13-3 4 
Se 
stors °F 
c d psw 
PS"! = 09000000 80001374 


st psw 55555 


d psw 
PSI = 09000000 0055555 


The contents of the PSW is displayed. The hexadecimal number 55555 is right 
justified, filled with leading zerocs and then stored in the second word of the 
PSW and the interrupt code set to zero. The PSW is then displayed to reflect 
the change. 


d. d nsw 
PS“ = NENNNDNA FANNL37h 


st psv 111111 120900 


fo onsw 
PS'j = AALINADONA O0N0120N0 


The contents of the PSW is displayed. The hexadecimal numbers 111141 and 
42000 are stored right justified in the first and second words of the PSW and 
the interrupt code in the first word is sct to zero. The PSW is then displayed 
to reflect the change. 





4.1.14 


SET 
: 4.1.14 SET 
Purpose: 


SET allows the user to (1) save. the card file in his 
virtual card reader, (2) control the messages and 
warnings typed at his terminal, (3) control his running 
status, and (4) convey information describing his 
physical terminal. | 


| 01/24/70 ; 


Format: 

3 3 ox ! 
: ' — CARDSAV OFF ; 
a t a 
: ' — MSGOFF i 
4 | 7 
4 i  MSGON ‘ 
i 
7 . RUNOFF | 
' SET  { RUNON H 
a é t 
: ' - WNGOFF. i 
~ 4 
t { WNGON ’ 
: Ce, ae OFF t 
if TIMEOUT “ON 

‘ f SHORT i 
: ! LINE LONG : 
t { { 
t i | 
if 4 TABS ny Ay eee a 7 : 


CARDSAV ON saves the card file in the virtual card reader 
so that it can be reread. 


CARDSAV OFF erases the card file in the virtual card reader 
once the reader has been closed. 


MSGOFF Specifies that no messages are to be typed at 
| the terminal. 


RUNON allows the user to activate the ATTN button 
, causing a "read" of a CP console function 
without stopping his virtual machine. When the 
. CP function is typed in, it is immediately 
executed and the virtual machine resumes execution. 


RUNOFF places the user in the normal CP environment | 
Such that when the ATIN key is hit, the virtual 
machine stops. 


td 





01/24/70 
. : . 4.1.14-2 
4.1.14 SET | SET 
WNGON specifies that all warnings are to be typed 
_ at the terminal. 
WNGOFF. | specifies that no warnings or messages are to 


be typed at the terminal. 


TIMEOUT ON specifies that the user's terminal is IBM 1050- 


like and lacks the timeout suppression feature. 


TIMEOUT OFF negates the effect of TIMEOUT ON. 


LINE LONG specifies that the user's terminal is teletype- 


like; but allows lines of 130 characters. 


LINE SHORT negates the effect of LINE LONG. 


TABS specifies physical tab settings on the user's 

i terminal to reduce the time required to print 
lines. 

Usage: 


SET CARDSAV ON does not erase the cards in the virtual 
caérd-reader once the reader has been closed. Therefore, 
the SET CARDSAV ON allows the same virtaul card input 
to be read repeatedly from the beginning of the file. 

If a file is not completely read and the user wishes 

to re-read it, "CLOSE devadd" must be issued, where 
"“devadd" is the address of the card-reader, to close 
the file and reposition pointers to the besinning of 
the file. The operation is effective for all the user's 
virtual card readers. 


SET CARDSAV OFF is the normal mode of opetatron for 
the card-reader. Once a virtual input has been closed, 
it is lost. To reread the file, it must be physically 
read into CP-67 again by the operator or via XFER. 


The normal mode of operation for messages and warninzs 
typed at the terminal is MSGON and oo respectively. 
Any messages directed to a user or broadcast by the 


operator will be typed at the terminal whenever the 


tyT 
terminal is not ready for input. A warning sent by 
the CP operator will print immediately regardless of 
what is occurring at the terminal. If MSGOFF is 
specified, only warnings from the operator will type 
at the terminal, and any messages sent by another 
user or the operator will be lost. 


Once MSGOFF or WNGOFF has been specified and the user 
desires to accept messages or warnings, SET MSGON or 
SET WNGON should be issued. 





4.1.14 SET | a 4.1.14, 


01/24/70 
SET 


If WNGOFF is specified, no warnings or messages will 
ever type on the terminal. If WNGOFF.and MSGON are 
both set, only messages will type on the terminal. 
SET WNGOFF should be used with discretion. 


The normal mode of operation for running is RUNOFF. 
When the ATIN key is hit, the virtual machine stops 
running and the terminal waits for a CP console 
function. Ina multi-access virtual machine, this is 
am acceptable method of operation; therefore, SET | 
RUNON can be issued to CP to allow the virtual machine 
to continues running when the ATTN key is hit. When 
RUNOFF is issued after RUNON had been previously set, 
‘the virtual machine will continue to run until the 

‘ ATIN key is hit; this will cause the machine to stop 
for input. The SET RUNOFF mode is automatically set 
if the user gets an "idle" virtual machine, i.e. with 
the message : 


CP ENTERED, REQUEST, PLEASE. 


For specific terminals (e.g., the IBM 1050), when the 
system is awaiting input from the terminal, the key- 
board will lock if no data has been entered for any 
15 second interval during the "read" request. If 
SET TINEOUT ON has been entered, the keyboard will 
unlock and allow the user to resume input. 


SET TIMEOUT OFF is the normal mode of operation and 
indicates that the timeout situation need not be 
considered. 


The standard teletype has an 80 character carriage; 

CP, therefore, will split a long line destined for a 
teletype or teletvpe-Llike device into two shorter lines. 
However, there are certain teletvpe-like devices that 
have full 130 character carriazes. The user may indicate 
that he has such a terminal by entering SET LINE LONG, 
thus requesting full 130 character output lines. 


SET LINE SHORT is the normal mode of operation for 
teletype users and indicates an 80 print position 
carriage. 


SET TABS informs CP where the user has placed physical 
tab settings on his terminal.. When a line is presented 
for terminal output, CP determines whether the user 

has requested that tabs be inserted in his output line. 

If so, any string of at least three (3) blanks extending 
to the user's tab settings will be removed, and replaced 
by a tab character. This reduces the number of characters 
in the line to be typed, and, thus, reduces the amount 

of time needed to type a full line of output. 


a aA A OSS PGI DP VGC) SER AED LED TA EP RET NE TIE EN 


i ae 01/24/70 
4.1.14 SET ; 4.1.14-4 


To alter a previous setting, simply issue a new 
_SET TABS command which will replace the old settings 
with the new. A SET TABS command with no specified 
teb setting will nullify any previous SET TABS command 
No tabs are assumed to be set until the first issuance 
of this command. A maximum of seven tab settings 
may be specified, and the tab settings specified must 
be. in increasing order. 
; ‘XN 


Responses: rit 
' BAY ARGUMENT xx 

An invalid argument was specified. 
Examples: | | | 
ae _ SET CARDSAV ON. 


The virtual input file will be saved and not erased 
once the reader is closed 


b. | SET MSGOFF. 


No messages will type at the terminal, only warnings 
from the operator. 


Ce SET RUNON 


The virtual machine will immediately continue 
execution. Ti the user now activates tne ATIN key, 
a CP 'read' will occur, but his virtual machine will 


continue to run. 
d. SET TIMEOUT ON 
The user has an IBM 1050 terminal without the timecut 


suppression feature. [If his keyboard locks, it will 
subsequently unlock and become available again. 


Ge SET LINE LONG 


The user has a teletype-like terminal with a 130 
character carriage. The full width of this carriage 
may be used for terminal output. 


f. SET TABS 10 16 31 40 

The user's terminal has tabs physically set in columns 
10, 16, 31, and 40 (relative to the left margin, which 
is column 1). All output to this terminal will be 
edited for possible insertion of tab characters. 

Se SET TABS 


This nullifies the effect of any previous SET TABS command. 





G.1.15  XFER 


-Purpnose: 


1/26/70 
hl isel 
xXFER 


XFER controls the passing of files between users, 


Form2t: 


Qo ee Rae Fe ON et ae te ee ee Oo 8 om O84 a CP OS oF on cae | 
' XFER ! DEVADD {To USERID| ! 
_ ! OFF i 
é t L § 
ee) ee ee ee —- ow eo a oe a a a os oo onl 


ZVADD 


TO USERID: 


OFF 


Use ra: 


Qerene mee ee on 


Specifies the address of the device from 
wnich all succeeding output is to be either 
transferred or normally written out. The 
acceptable devices are the card-punch, 
normally 09D, or the printer, normally 

OOE. 


Turns on the transfer mode. "USERID" is 
eication 


the ecignt-cheract: 
of the user that 
file, 


Terminates the transferring of all further | 
GUitput to: “UserID, 


AFER cont See the passing of files between users, When 
the transfer mode is turned on by soecifying "TC USERID" 
any stcceeding cutcnuc written to "DEVADD' will be placed 
in, the errc-rcacer of "yeeRiD'. Foe “USERID” to sedaive 
the trensferzved files on his disk, "USERID" must read them 
into his files. i.a., by issuing ccwnends such as 
"OFFLINE READ FILENAUE PILI iek or, in the case of ; 
punched files, “RISK LCAD." To turn the transfer mode 


off, the option © 
output to the 
normal spooling 


is free, 


A second XFER command 
automatically turn 


'CEF'' must be specified, Any succeeding 
UDEVADD' will. be written -onte- disk. as in 
and put on the real device wnen that device 


will 
"USERID." 


"USK niTp" 
e previous 


issued to 
of£ the XFER 


an ©) 
oO 42 
r3 
Eee) 
~ CQ 
Q 
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7 XEER 
“Responses: @ 
BAD ARCUNENT, | —_ —* 2 


An invalid arguzent was specified. 


NONEXISTANY UNIT. 
The specified unit does not exist and is invalid. 


Examples: 


A. . XFER D TO USERL 
The transfer mode is turned on. Any succeeding output 
to device 00D will be piaced in the card-reader of USERL. 


B. XFER D CFF | 
The transfer mode is turned off. Any succeeding output 
to virtual COD will be written on the real device. 


C. XFER E TO USER : 7 
The transfer moce is turned on. Any succeeding cutput 
to device 002 will be placed in the card-reader of USERL. 


¢ 


01/24/70 
4.1.16-1 | 
PURGE 


4.1.16 PURGE 


Purpose: 


PURGE allows the user to delete some or all spooled 
files still in the spooling area from his virtual 
printer or punch, or to delete some or all of the 
spooled input for his virtual card reader without 
‘reading the data. 


FORMAT: 


t — - 6 
READER 
R 


PURGE 
ae 


PRINTER ee 
Pp _ <n> 


PUNCH 
PU 


OE CP OE Ge OD GO TD OF 02 ON a Ew Om 
errr LS tt tr 
(2 Gn OD GH OR CR GD US OH AD OH EM ER HD OD 6” OR ED Om On 


fc 
’ 
] 
8 
8 
$ 
8 
i 
’ 
‘ 
' 
‘ 
' 
' 
’ 
i 
$ 
§ 
4 
t 
! 
t 
' 
‘ 
’ 
¢ 
t 
t 
t 
‘ 
é 
‘ 
' 
! 
5 
a 
t 
i 
u 


where n is the number of files to be purged, expressed 
as a decimal integer. If n is greater than or equal to 
the user's total number of files for that virtual 
device, all of the files for that virtual device are 
purged. The number n, if specified, must be greater 
than zero. If n is omitted, all files for that device 
will be purged. 


Usave: 
If the user determines that he does not require the 


first n (possibly all) files in his virtual printer, 
punch, or card reader, the PURGE command can be issued. 


Responses: 
BAD ARGUMENT XX 


An invalid device type was specified, of the number 
of files to be purged was invalid. 
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4.1.16 PURGE. 


xx FILES PURGED 
This is the normal response, where Mae¢H is the number 
of files actually purzed, or the word NO, if there 
were mone to purge. 


Examples: 


ae purge pun 

NO FILES PURGE 
‘There were no punch files awaiting spools? pene 
for the user. 


“hs purge reader 6. 

be. er 04 FILES PURGED 3 
The user wished to purge the first 6 reader spooled 
files. Only 4 such reader files existed, and these 


4 were subsequently purged. 


+ twemrte 


a 


05/01/69 
the userid is invalid. Bey 
; O36 
1f the user “XFERed" tc is currently logged on to CP-67, he will 
receive the folloving\ message: 


$* ae XFER’*D BY userid ** 


there userid is the trasferring user. 
\ 
dotes: 4 
A user may dc an XFER to hitself tc allcw him to. read a card file 
he created without requiring operator intervention and at a 
consideratlje savings in card \pandling. 










FesEctsess 


BAL ARGUMENT xx 
An invalid argument was specified 


NCNEXISTENT UNIT 


The specified device dces not exist ‘and is invalid. 


DEVICE EUSY 
Spocled ¢utput is in operation for th 


punch. A ‘closet should 
ke issued tc clear the status. 


Exangles: 


Ae xfer d to user 


Ihe transfer mode is turned on. Any succedgding output to device 
QOL will ke placed in the card-reader cf USER1. 


Le: xfer ad cfft 


The transfer made is turned cff. Any succ 
virtual OCT will be written on the real device, 


eding output to. 


c. xfer d to usera4- 
USFRAY NOT IN DIRECTORY ‘ 

oe \ ; 

USERAY docs not exist, therefore cards will not be transferred ‘to 


‘him. Any, active transfer mode is turned cff. 


d. CE Qe cer rrn- environment confirmation 


Wy L.18-2 


Cod 


‘ 05/01/69 
x 4 to user20 L1,15-3 
begin : y . 4 3/ fia 
CHS Lv 
disk dump document scrift 
R;31*02. 19 


** CARDS XFER‘D BY USERS ** 
offline read prog2 datain 
6 


4 


Output device 00D is transferred to USER20. Control i's returned 
to CMS by issuing BEGIN to CP, and the file DOCUBKENT SCRIPT is 
transferred to the card reader of USER20 in disk dump format. 
Heanwhile, cards were XFER*ed to this user Ly USER4Y and he reads 
them onto kis disk. 
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Bai, ey 


4.1. 16 PURGE 


Purpose: 


PURGE allcws the user tc delete aj] spooled files (not currently 
Frccessed for output) from his virtual printer or punch, or to 


delete al] his specled input for his virtual card readers without 
reading the data. 






Format: 
I { READER 
l ! R 
| PURGE ! PRINTER 
i P I P 
J i . 
j | EUNCK 
i i PU 
Usage: 
If the user deterrines that he\ does nct require either his 


£pcoled Print output, Or punch output, or if he wishes tc purge 
411 his input reader files, the PURGE ccmmand can be issued. 


+ 


BAD AEGUMENT xx 
An invalid device tyre was specified. 


xx FILES PURGED 
This is the normal response,'where "xX" is the nupker of files 
éctually purged cr the werd NO, if there\were none to purge. 


Exatgles: 


a. purge pun 
NO FILES PURGED 


There were no funch files awaiting spooled utput for the. tsex: 


i. pur x 
02 FILES PURGED 


The twe efcoled input files for the user have heen deleted. « 


. ‘ . | @. 
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4.1.17 SLEEE Kit 
G33 
Furrcse: 


SLEEP allews the user to place his terminal in a dergant CP rede 
such that he may receive messages without hitting carriage 
return. 


If the user does not expect to be using the terminal fer a while, 
the SLEEP conscle functicn will lace the terninal in a state to 
receive messages. The user's virtual machine is not run, but he 
is still accounted for "“ccnnect" tine. The terminal can he 
"awakened" by activating the ATTN key which returns the user to 
cP fer mcre input. 


ete a ee 


Exgaples: 


ae sleer 


The terminal is placed in a dormant state to 
“Warnings” set by the operator are not affected. 
done a SETI MSGOFF he will cf ccurse net receive 
warnings, if they are issued. 


receive messages. 
If the user has 
messages, only 
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7 ; y.1,18-2 | 
4.1.18 SPOOL : 47 When multiple physical card decks have been spooled onto disk by 274 
SF CP, a user must Close each file before the next file can be read, 
Furcese: . For continucus virtual card reader input such that the card 
. ‘reader doer not have to be closed ketveen each file, the SPOOL 
: coumand can ke issued specifying the virtual card reader address 
tie Spery ; : and CONtm. The virtual machine will rceceiya. an end-of-file 
ie congzole function allows the user to (1) direct his indication only after the last card of the last spooled input 
Specled cutput te a specific unit reccrd device at the computing file has been read. 
oe ard (2) to FOutros the nature cf reading spcoled input af 
e s es * i 
; Jo terminate the continuous reading of files, issue SPOOL 
Fora -Specifying only the virtual card reader addcess,. 


— — me we lee — eee le 


axe <ON yyy> 


ccc <CONT> 


is the virtual device address fror shich 
output is to ke directed to the specific 
rea] device, yyy. 


XXX 


is the real device address cf the desired 
output unit. It can only be a printer or 
punch address. 


yyy 


is the virtual device address cf the card 
reader that is to have "continuous" 
Spccled input. 


ece 


sage: 


When printing or punching files teow virtual devices, the cutput 


is written to disk or “specled" until the physical device is 
available for use. If there are multiple printers or punches,. 
the first available device will ke used for the cutput. To 
control the sycoled output direction, SPOOL can he issued 
specifying the virtual device address and the real device to 
pag tt Regine Sshculad qc. The virtual and real device types 
pus e the sane; in ‘cther words the virtual punch c 

directed te the real printer. : ~ seas sae 
To discontinue the directed Spooling and return. te “nonmal 


spcoling, issue SPOOL specifying cnly the virtual device aadESsnt 


SPCCL alsc controls the virtual card reading chatacterié stics, 


ae Continuous reading of input files shculd not be in effect 
-with SET CARDSAVE ON, as an unending “wrap around" input file. 
will exist. 


usefull and necessary if, for instance, an 
installation has two printers; one with a "PN" train and another 
with a "IN" train, If-th user has "script" output tc produce, 
he may specify the desired cutfut printed, perform his printing, 
and then return his printer to normal spcoling. 


bh. Directed output is 


fespopses: 


BAD ARGUMENT xx 


This indicates that an error in specification en been nade, such 


as invalid.virtual address, invalid ‘real address, or conflicting 
device tyres. uO 
Exaurles: 

ae Spoc] e cn 30 

begin 

CHS 

script-.print report (offline center) 

R:T=C5.21 

Kreme ATIN key hit 
CP , < laeehateaied ccnfirgsaticn cf environment 
ep e ; é 


The SPCOL console function is issued to CP to direct the virtual 


peinter OCE cutput to the real frinter 930, BEGIN returns 
ecntrol te CMS, where REECRT SCRIPT is formatted cffline. THE 
ATTN key is hit te ge to CP and the directed output cf printer 


OOE is terainated. Normal spooling will now occur on OOF, 


b. Spool c cont : . 


nn ' 
ES A HSE AT A TS SEIS. 
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offline read * * 4.1.19 DISCONNECT 


4.1,18-3 eae: 
beqi : 2 . Oy 
cHs 7 c 536 yp | | SB/ 


OFFLINE READ A FORTRAN 


CFFLINE READ E FORTRAN 
OFFLINE REAL CALC FORTRAN - Purpose: 
R;1=02.01 
pee 2 aaa ATTN key hit DISCONN causes the terminal to be disconnected from the 
‘query files a : virtual machine and the virtual machine continues to 
FILES: - NO RER, 03 PRT, NO PCH run, 
spocl c 
Format: 
The SPOOL command is issued to read multiple spooled input files 
as if they were continuous. Control is transferred to CHS by . : en ae SOREN ES 
BEGIN and the spocled ingut files are read. ate ATTN key aes ‘ae ' ‘ 
to return to CE and the spooled files are quered. Input spocling 
is then returned tc normal for ncn-centinucus reading. | DISCONN | <anything> | 
. . . ’ ; e 
anything is any non-blank character string 
that stentfies the phone line [fs 
not to be hung up upon DIS (ONNecting. 
Usare: 


DISCONN causes the terminal to be disconnected from the 
virtual machine. the virtual machine will continue to 
run as though the user had issued BEGIN. Any "writes" 
to the terminal (virtual console) are tgnored. The 
. ~ Virtual machine will be automatically logged out if (1) 
if 4 24 , : -* @ "read" is attempted from the terminal, or (2) the 
virtual machine goes into the disabled wait state. The 
DISCONNected virtual machine will run with low priority 
In Q2 of the dispatcher. 


If the <anythIng> option is selected, the line will not 

: . be disabled. The terminal can then be used to "LOGIN" 

gre , : with another "userid" or to DIAL Into a multl-access 
, : " system, : 


At a later time, auser can "re-connect" with his 
DISCONNected machine simply by following the normal 

. ; "login" procedure. this “re-connection" can be made 
from any terminal. The message: 


RECONNECT AT XX/KX/ XX ON XX/XX/ XX 
( we , will be printed upon re-connection and the terminal 


; , will be placed in console functlon mode. To cont inue 
running the virtual machine a BEGIN {fs required. 
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4,1.20 LINK LINK EMG 
| , , SBE 
Purpose: _ ce ' 


| 


LINK attaches the speci fled device |to the requestor's 
virtual machine, based on tnformation contafned In the 
CP-67, User Directory. ! 

} 
Formats 


a Ce ee rer eee tee er ee) 
' 


usertd xxx yyy <W,R> <(NOPASS)> 


usertd The name of the user "ownllng" the device xxx 


XXX The “owner's” virtual device address In 
hextdectmal 

yyy The hexidecitmal. address to be assigned ‘in 
the requestor's virtual machine 

W write access mode Is ca a 

R Read access mode only Is requested, 


This Is the default valuel, 


(NOPASS) Used only if no special password Is required 


for the desired access mode (l.e. a "public" 
device), 


ares 


LINK allows attachment of directory-defined virtual 
disks to the requestor's virtual machine. The device must 
be described In the CP-67 Directory under the name an 
device address ( userlid,xxx ) specified, 

If the userld Is that of the requesitor, no password {ts 
required, and rules governing access aye the same as 
prevall at LOGIN time, However, If wrlite access Is normally 
allowed, but 'W' Is not specified, read-only access will 
be set. This allows. the requestor to establish write 
protection on a device. 


If the LINK Is to some other userld, a password for the 


— 
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4.1, 20-2 ; 
LINK LLY 


destred access must be provided, See Responses. O27 
ra eaninnaly any number of users cah ‘link! sImul taneously 

to a device In read-only mode, Only user can have ure 

access to a device If the flest link fas write Berea ars ae 

read-only link exists, and a write request Is ‘Issued, 

wll} be made In read-only mode, 


Responses ; 
ENTER PASSWORD: 


"0 | Ifled 
nquired password, By. conven ton, devices spec 
LP osaui te! have the password 'ALL', A null Vine witl default Co 
ALL. ; oo 


BAD ARGUMENT 






Missing or Invalld arguments. 
COMMAND ACCEPTED | | 
The request has been honored as given), 
READ-ONLY | } 
A wrtte request cannot be honored due to existing pege Vink(s). 
NONEXISTENT UNIT . : | | 
Device xxx not found In the’ speci fled directory. 
“ALREADY: ATTACHED ; | 
Requestor already has a device yV¥e 
BAD PASSWORD , . 
The supplied password Is not valld, or sheen Is not sharable. 


USER LOGGING IN ie 


 hueeeia is tn process of logging In. Try again later. 


DEVICE IN USE. | 
A write link exists. LINK denied. | 
UNIT NOT READY > 


“The required physical volume Is not mounted, Notify system operator. 


~~ 
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jf . ee Ae 
UNIT NOT DASDI me ee ! LINK S% ig 
Device xxx must be a DASD! dev ce ‘for LINK. . 
USER OT ON SYSTEM le ct ok 42.0 
"userid' Is not In the directo Ye | 


ee 
«! 
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Console Function Applications 


Camsole functions give the facilities of a computer console to each 
virtual machine and they should be used accordingly, It is through 


‘these functions that a virtual machine is loaded, displayed, dumped, 


altered, and controlled by the user, 


Console functions have various uses. Some of the application areas 
are described below, suchas debugging, initializing CMS, and 
attaching/detaching additional I/O devices. 


Debugging. Console functions are very useful for debugging purposes. 
The CP environment can be entered at any time and the contents of core 
storage, the registers, and the PSW displayed, dumped, or altered. 
Execution can be started again by issuing BEGIN, with or without a 
specified hexadecimal location, 


if the CP environment has been entered from CMS and the user desires 
to enter the Debug environment of CMS, he can issue EXTERNAL. The 
EXTERNAL console function generates an external interrupt and causes 
DEBUG to be entered when BEGIN is issued or the ATTN key is hit, 


Initializing CMS. If at any time the user destroys his copy of CMS, a new copy 
can be loaded again by issuing "IPL CMS" or "IPL 190". All pending interrupts 
are reset and CMS is started anew. ~~ > 
If 1/0 errors occur on the disk when logeing in to CMS, the file directory from 
the permanent disk has probably been read into core incorrectly. DO NOT LOG. 
QUT. Issue “IPL CMS" or "IPL 190" again to initialize CMS. a 





Attaching /Detaching Additional 1/O Devices. If an 1/0 device such as a tape 
drive, is needed that docs not belong to the virtual machine configuration, the 
user must commuticate with the Cr operator that he wants a device attached 
with a spccificd address, such as 181. As soon as the device is attached by the 
operator, the message ''DEV devadd READY" is typed out at the terminal. The 
specified device address can now be used. 





The user can continue using the terminal while he is Wailing for a device to be 
attached as long as he does not address that device. Once the device is attached 


and the appropriate message is typed out, the specified device is dedicated to 
the onc user. ‘ . 


6-15-70 
Wad, 2nd 
CARDS 


PURPOSE: 


The CARD command can be used to control the order of spooled 
reader files. 


FORMAT: 
ee Ee aida al ober eee a i 
FIRST 
CARDS ' Nl LAST 
i i I N2? i 
Me i iss aS ams, int ck Sa eS” ec et es am: sy chan tow ttn esl“ cAI cl eo om < l,i 
Nl Specifies the reader file which is to be moved. It 


can be any number Ol to NN depending on how many reader 
files the user has spooled. But it must not exceed 
the total number of files available. 


FIRST Specifies that the reader file designated by Nl is to 
be moved to the beginning of the reader file chain, 
making it the first file in the reader. 


LAST Specifies that the reader file designated by Nl is to 
be moved to the bottom of the reader file chain, 
making it the last file in the reader. Any new file 
read in is located last. 


N2 Specifies the reader file that is to be swapped with 
Nl. It can be any number 01 to NN. When a swap is 


made all other reader files remain in their same 
relative positions. 


RESPONSES: 


COMMAND ACCEPTED 
The file designated by Nl was successfully moved. 


FILE NOT FOUND 
The NI or N2 File is not present in the reader. 


BAD ARGUMENT 
An invalid argument was specified. 


EXAMPLES: — 


When. there are four files in the reader, the following commands 
are given: . 


A. CARDS 03 FIRST 
The third file in the reader becomes the first; 
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B. CARDS O1 LAST 
The first file in the reader becomes the last; 


C. CARDS 02 04 | 
The second file becomes the fourth and the fourth becomes | 
the second. The first and third remain the first and third; 


D. CARDS 04 02 
Same results as C. 
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, re 5.1. 0-1 


There is no tape label checking performed by CP. It is up-to the operator to . 5.1.0 RECOVERY PROCEDURES 


mount the correct tape. : i a 3 . ; 
P The recovery procedures discussed in this section deal with error 


recovery as well as general. recovery from user problems, The 


The responsibility is left to the user to detach or remove the specified device : ] 
~ P y i e recovery procedures are as follows: errors during LOGIN, errors 


from his configuration, As long as the device is attached to him, it is unavailable ee ion : : 
for use by any other user. By issuing "DE’TACII devadd", the device is removed specified by the I.(xxxxx) message, recovering from the system going 
from the virtual machine configuration and the message "DEV devadd DETACHED" down, re-initializing CMS, file space full, on general aii 

is typed out at the terminal. A message is automatically typed out to the operator procedures, 

specifying the device that is free. If the detached device address is that of a tape 


drive, the tape till be rewound and unloaded. Errors During LOGIN: If I/O errors occur during the CMS command 


"ELOGIN UFD" or after CMS initialization and either a carriage return 
or the first command has been issued, CMS has recognized an error 
condition while trying to read in the user file directory and will re- 
' peat the LOGIN procedure, The user will be asked to LOGIN again, 
' Re-issue the command "LOGIN UFD", If the I/O error still occurs, 
enter the Control Program by hitting ATTN and issue "IPL CMS" to 
reload the Cambridge Monitar System, Issue ''LOGIN UF D" again, 
If the I/O error still persists, contact the responsible system programmer, | 
as the user file directory is unreadable or has been destroyed, 





If 1/O errors occur during the CMS "LOGIN NO_UFD" command, issue 
"FORMAT P" to re-initialize the permanent disk. If errors occur 
4 , _ during "FORMAT P", issue "FORMAT P ALL", 


Errors Specified by the E(xxxxx) Message, Any error conditions that occur 
during a CMS command are typed out with an E(xxxxx) message when 

the command is terminated, The xxxxx is the error code nurnber and it is 
explained in Appendix C, If files were permanently writlen out or updated 
before the error condition occurred, the most current files are reflected 

in the user file directory when the time (T=xx, xx) is typed out, unless other- 
wise stated by that command's description, 





Recovering from the System Going Down, If the system goes down while 
using CMS, the files on the temporary disk are lost and the files on the 
permanent disk are as current as they were when the last Ready message 
(R;T=xx, xx) or crror message (ME(xxxxx); T=xx, xx) was typed out, with one 
exception. If an EXEC command had been issued, the files used by the CMS 
commands that had finished execution before the system. went down will be 
reflected in the current user file directory even though no time (T=xx, xx) 
was specified between the commands, Except in the case of EXEC, the | 
user file directory is always updated on disk whenever the time (T=#xx, xx) 

is typed at the terminal, 


If a file is being edited or created by EDIT when the system pocs down, it 
may not be completely lost. Issue a LISTF and see if the EDIT work files - 
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oe oO 


"INPUT FILE" or "INPUT1 FILE" exist. If they both exist, take the 
longer of the two if you are creating or adding to the file, or take the 
shorter file if you are deleting many lincs, and then proceed as below; 

if they both exist and are the same length, issue a PRINTF or OFFLINE 
PRINT for both work files to see which work file has the latest copy of 

the file being edited and then proceed as below; if only one work file exists 
then proceed as below. 


ALTER the filename and/or filetype of the appropriate work file. Then 
issue EDIT for the ALTERed file and begin editing, as this file contains 
the latest copy of the file that was being edited when the system went down. 


If no work file exists, all input and changes made since the last FILE or 
SAVE request have been lost. To prevent the updated or new file from 
being lost, issue the FILE or SAVE request frequently, 

e 
Re-initializing CMS, If DEBUG is entered, CMS can be re-initialized as 
follows: (1) the CMS "IPL" command can be issued from the DEBUG 
environment or the CMS command environment, (2) the ATTN key can be 
hit and "IPL CMS" or "IPL 190" issued to CP, or (3) "KX" issued in DEBUG 
and then "IPL CMS" issued to CP. Issuing "KX" to DEBUG is the only way 
among the previous three methods of re-initializing CMS to permanently up- 
date files that have been updated or created since the last T=xx, xx message, 
The Restart request in DEBUG should not be used as an all-purpose re- 
initializer, as it is primarily a special debugging feature for checkout of 
experimental systems and it is basically an in-core initializer. 





If CMS does not work as it'should, it could be that the copy of CMS in ths 
virtual machine has been destroyed by the user (no user can get to or 
alter another user's virtual machine or core storage). The user should 
either (1) enter the Control Program by hitting the ATTN key and issue 
"IPL CMS" to reload CMS, or (2) issue "IPL" to the CMS command 
environment. 


The commands "IPL", "LOGIN", and "FORMAT" can be issued at any time 
in the CMS command environment and not ‘just at the beginning. 


File Space Full. If 99% of the user's filespace is full, an crror message 

is typed out and the user is logged out of CMS. Issue "IPL CMS" to CP 

and if at all possible, erase some files, If there is still not sufficient 

space available on the disk, dump all or part of the files onto tape with 

the CMS commands "TAPE DUMP" or "DUMPREST"! and then crase those 
files on disk. Whenever the files on tape are needed, the commands !'TAPE 
LOAD" (if "TAPE DUMP" created the tape) or "DUMPREST" (if "DUMPREST" 
created the tape) could read them back onto disk, If the user still needs 

more filespace, he should contact the system administrator for more disk 
space, 
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General Recovery Procedures, If it is not clear which environment has 
been entered, hit carrige return and the response will confirm which en- 
vironment has been entered, 


To kill exccution of a command or program in CMS, the ATTN key should 

be hit twice and "KX" centered, To kill a type out in CMS, the ATTN key 
should be hit twice and "KT" entered. To kill overrides in CMS, the ATTN 
key should be hit twice and "KO" entered, To truncate a line to 72 characters 
that is being typed out at the terminal, the ATTN key should be hit twice and 
"KE" entered, 


If all of the files on the permanent disk are to be crased, the command 
"LOGIN NO_UFD" should be issued ingtead of "ERASE * =", 


If errors persist in an executing propram, use the DEBUG command (see 
Section 3.3.2) or, if the program is written in Fortran, use the Fortran G 
Debug package (see IBM System/360: FORTRAN IV Language, Form 
C28-6515), 


If transmission crrors occur, issue the ECHO command, using each of the 
options U,S, and X (see Section 3.5, 2) to test the transmission of data be- 
tween the terminal and the computer, 
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OFFLINE PROCEDURES oo ee THE 474 


The read cards into a user's file, the CPPLINE READ ‘command is 
used. The first card in a deck. to be read must be the centrol 
card . : 

CPG7USERID userid 


where the user's ID is punched teginning in colunn 13 {i.c., two 
spaces between CP67USEBID and the user's IDL). 


Cards are read by the OFFLINE REAL command in CMS anda file is 

formed which is referred tc by its filenane and filetype. The 

ccntrol card . 
OFFLINE REAL name type mode 


specifying the filename and filetype, sheuld be placed before 


. each set cf cards which is to form a file where “"nare"® is the 


filenarc, "Lype" is the filetype, and "mode" is the filemode. If 
the "ede" ig not specified, each file will be entered into the 
user's file directcry with made Pl. 4 


When a usér wishes to have a deck cf cards read in offline, he 
ehculd give the deck to the CP operator and request that his deck 
te read into CP. If the user was logged in before the deck was 
read Ly CF, the follaving ressage will be typed at the console. 


*##CARDS HAVE BEEN KEAD** 


Jf the deck was read by CP befcre the user logged in,’ the 
£Ecllewing nessage will be typed at the console as saon as the 
user legs cn: ~ : 


FILES: - xx RDR, xx PRT, xx PCH 
When the deck has been read by CP, the user should issue the CNS 
command 
CFFLINE REAL * 
to cause CHS, te read the cards and form the desired files. If 


the deck ig read by CP but the CMS command OFFIINE BEAD is not 
issued, the files will not he entered into the user's directory. 


5,.3,0 
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CHANGING OBJECT PROGRAMS 


Files which contain relocatable object code and have a filetype of 
TEXT can be read into core storage and have their linkage's resolved 
by the LOAD, USE, and REUSE commands, Three types of cards 

can be added to a TEXT file. These are the Set Location Counter 
(SLC), the Include Control Section (ICS), and the Replace (REP) cards, 
which are used to set the core location whére LOAD will begin placing 
the file in core and to make corrections and additions to the relocatable 
object code in core once the file is loaded, These cards can be added 
to the TEXT file(s) which have been OF FLINE PUNCHed and then they 
can be read back in, or they can be added using the SPLIT and COMBINE 
command or the EDIT command, ; 


Set Location Counter Card. The Set Location counter card sets 

the location counter used with the loader. The file loaded in after the 
SLC card will be placed in core beginning at the address set by this 
SLC card, The SLC card has the format shown in FIGURE 5, 3, 9-A, 
It sets the location counter in one of three ways: 


1. With the absolute address specified as a hexadecimal 
number in columns 7-12, 


2. With the symbolic address already defined as a program. 
name or entry point. This is specified by a symbolic name 
punched in columns 17-22, 


3, If bath a hexadecimal address and a symbolic name are 
specified, the absolute address is converted to binary and 
added to the address assigned to the symbolic name; the re- 
sulting sum is the addregs.to which the loader's location 
counter is sect. For cxample, if 00008 was specified in 
columns 7-12 of the SLC card image and GAMMA was 
specified in columns 17-21, where GAMMA has an assigned 
address of 006100 (hexadecimal), the absolute address in 
colurnns 7-12 is added to the address assigned to GAMMA 
giving a total of 0061F8, Thus, the location counter will be 
sect to OOGLF'S8, oan 


If there are blanks in both columns 7-12 and 17-22 or the symbolic name 
has not yet been defined, the response "INVALID CARD xxx,.. xxx!" is 
typed out or, depending on whether the LOAD option SINV or PINV was 
specified, is written in the file LOAD MAP, If only the symbolic address 
is to be used, columns 7-12 must be left blank or all zeros, If only the 
absolute address is to be used, columns 17-22 must be left blank, 
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or insert program identification for his own convenience. 


5, 3. 0-2 
Set Location Counter Card 
PERS Ei a Sos e Serie Rese aaa a a aa i aac a ‘ 
Column . 4 Contents : 
fen eee eenn' fo ncacrectten eran en enn ene een meee nent neeenen ence nceeeeenes 
: 4 ' 
: ; . 
eee : Load card identification (12-2-9), Identifies this as a ' 
: ‘ card acceptable to the loader. : 
' ' ’ 
' ‘ , ’ 
1 2.4 : SLC. Identifies the type of load card, : 
; 
'' 5.6 : Blank, i 
: 1 | 
| 7-12 : Address in hexadecimal (to be added to the value of the ‘ 
: ' symbol, if any, in columns 17-22), The address must : 
; ' be right-justified in these columns, and unused leading ' 
; ' columns filled in with zeros. ‘ 
‘ 4 is ate 
113-16 t Blank, ' 
' ‘ 1 
' ' ' 
117-22 H Symbolic name, whose assigned location will be used b i 
i : y & y ' 
: ‘ the loader, The symbol must be le(t-justified in these t 
i ' columns, If left blank, the address in the absolute ficld t ’ 
: ' is used, : : 
' ' ‘ 
a , t 
' 23 i Blank, ' 
t it . i 
! oe 
124-72 ‘ May be used for comments or left blank, ' 
s 
r $ . ’ 
173-80 Not used by the loader, The user may leave them blank 
t 
t : 


y 
t 
t 
4 
' 
' 
1 
1 
t 
' 
' 
' 
' 
2 
t 
i] 
{ 
1 
t 
4 
' 
t 
t 
t 
' 
a 
i 
t 
‘ 
f] 
7 
' 
‘ 
' 
t 
! 
1 
i 
t 
t 
t 
€ 
t 
1 
1 
’ 
' 
if 
' 
! 
' 
1 
t 
t 
i 
’ 
t 


FIGURE 5,3,0-A. Format of an SLC card. 
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Include Control Section Card, The ICS card changes the length of a 
specified control section or defines a new control section. It should 
be used only when Replace cards cause a control section to be in- 
creased in length. The format of an ICS card is shown in FIGURE 
5,3.0-B. An ICS card must be placed at the front of the card deck 
or TEXT file. a 





Replace Card, A Replace card allows instructions and constants to 

be changed and/or additions made, The REP card must be punched 

in hexadecimal code, The format of a REP card is shown in FIGURE 
5.3,0-C. The data in columns 17-70, excluding the commas, replaces 
what has already been loaded into core beginning at the address specified 
in colunns 7-12. REP cards are placed in the card deck either (1) , 
immediately preceding the last card (END card) if the text deck does 

not contain relocatable data such as address constants or (2) immediately 
preceding the first RID (relocatable dictionary) card if there is relocatable 
data in the text deck, If additions made by REP cards increase the length 
of a control section, an Include Control Section card, which defines the 
total length of the control section, must be placed at the front of the deck, 


2-4 
5-16 


17-22 


23 
24 


25-28 


29 
30-72 


73-80 


5,3, 0-4 
Include Control Section Card 
wenmnrenwwe es aun ae wo 0 ne ae ee en nae ee Fenrer aw eraennnananaeaen ae ee , dladeteetaedtaal | 
Contents a 
is baits ccaranlev ar teenie cosets tien wo las elo mie bleim'e eee wecinee deen waa a de cioee i 


Load card identification (12.2.9), Identifies this as 
a card acceptable to the loader, 


ICS. Identifies the type of load card, 


Blank, 


Name of control section, left-justified in these 
columns, 


Blank, 

, (comma) 

Length (in bytes) in hexadecimal notation of the control 
section, This must not be less than the actual length 
of a previously specified control section, The number 


must be right justified in these columns, and unused 
leading columns filled in with zeros, 


Blank. 

May be used for comments or left blank, 

Not uscd by the loader, The uscr may leave them 
blank or insert program identification for his 


own convenience. 


(oe eh em ae on Be ow am me me oe me ee am oe fe On oe Oe mt Oe OR oy om Ot GY ee fe om mE im me me OF Ge ae om oe oe me me me on me Ow OF On a ae me Oe me 


FIGURE 5, 3,0-B, Format of an ICS card, 


ee? 


5-6 


13-14 


15-16 


17-70 


71-72 


73-80 
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Replace Card 


Load card identification (12-2-9), Identifies this as 
a card acceptable to the loader. 


REP. Identifies the type of load card. 
Blank, 


Starting address, in hexadecimal, of the area to be 
replaced, as assigned by the assembler, It must 
be right-justified in these columns, and unused 
leading columns filled in with zeros, 


Blank, 


External Symbol Identification (SID), which is the 
hexadecimal number assigned to the Control section 
in which replacement is to be made, The LISTING 
file produced by the compiler indicates this number, 


A maximum of 11 four-digit hexadecimal fields, 
separated by commas, cach replacing one previously 
loaded half-word (two bytes). The last field must 
not be followed by a comma, 


Blank. 


Not used by the loader, The user may leave them 
blank or insert program identification for his own 
convenience. 


FIGURE 5, 3,0-C, Format of a REP card, 


S57 
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5. 4.0 LIBRARY USAGE 


CMS has two types of libraries - macro libraries and text libraries. 


Macro Librazies. A macro‘library is created by the MACLIB command; it is 


a file tha as a filetype of MACLIB and that contains macro definitions and a 
dictionary. A macro definition is a group of assembler language state- 
ments identified by a unique name and used as an expansion of a source state- 
ment in an assembler language program. The dictionary is generated by the 
MACLIB command and is made up of macro definition names, the indexes or 
locations of the micro definitions within the library, and the size or number 
of curd images in cach macro definition. 








Both the user and the system may have macro libraries. The system macro 
library has the idewifier SYSLIB MACLIB SY and resides on the system disk. 
It is composed of commonly used macro definitions. The usex can generate 
his own libraries on his permanent disk by issuing the MACLIB command (see 
Section 3.4. 40). 


Macro librarics arc searched during the ASSEMBLE command for missing 
macro definitions. Normally the only macro library scarched is SYSLIB 
MACHIB SY. Once macro libraries have heen generated hy the user, there 
are two methods by which the user's MACLIRB files can be searched for missing 
macro defsinitions, 


The first method is by issuing the GLOBAL ASSEMBLER conmmand (sce Section 
3.2.2). This command names from once to six MACLIB files that are to be scarched 
for missing macro definitions. Jf the file SYSLIB MACLIB is to be searched in 
addition to the user's MACLIB files, SYSLI3 must be specified as one of the six 
libnames in the GLOBAL ASSEMBLER command. ‘The MACLIB files are searched 
in the order in Which they are named. The GLOBAL macro librarics remain in 
effect until either another GLOBAL ASSEMBLER command is issued, the CMS 
nucleus is re-initialized, or the user logs out of CP, 


‘The second method is by generating a SYSLIB MACLIB file on either the permanent 


or temporary disk. The ASSEMBLE command normally searches for the file 
SYSLIB MACLIB for missing macro definitions. In looking for SYSLIB MACLJB, 

the ASSEMBLE command searches the permancnt disk, the temporary disk, and then 
the system disk in that order. Jf a user file has the identifier SYSLIB MACLIB, it 
will be used in place of the system macro library. 


To terminate the searching of all MACLIB files, including SYSLIB MACLAB, the 
GLOBAL ASSEMBLER command can be issucd with no libnames specified. 
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Text Libraries. A text library, created by the TXTLIB command, is a file that 
has a filetype of TX TLIB and that contains a dictionary and the relocatable object 
code from ‘TEXT files. The dictionary is created by the TXTLIB command and 
contains control section names, the entry points, their location, and the size of 


each TEXT file included in the text library. 


Both the user and the system may have text libraries. The system text library 

has the identifier SYSLIB TXTLIYB SY and resides on the system disk. It is com- 
posed of the FORTRAN library subroutines. ‘The user can pencrate his own text 
libraries on the permanent disk by issuing the TXTLIB command (sce Scction 3. 4. 46). 


Text libraries are searched by the LOA, USK, and REUSE commands to find 

* missing subroutines when resolving external references. Normally the only text , 
library searched is SYSLIB TA'CIIB SY. Once text libvarics have been gencrated 
by the user, there arc three methods by which the user 's text libraries can be 
searched during the LOAD, USK, and REUSE commands. 


The first method is by issuing the GLOBAL LOADER command (see Section 3. 2.2). 
This command names from one to four TXTLIB files that are to be scarched for 
missing subroutines. If the fil: SYSLIB TXTLIB is to be searched in addition to the 
user's TXTLIB files, SYSIIB raust be specified as onc of the four libnames in the 
GLOBAL LOADER coinmand. ‘he TXTLIB files are scarched in the order in which 
they are named. Lf the GLOBAT, LOADER conmand has been issued and the user 
wishes to terminate the use of his TX''TLJB files, the GLOBAL, LOADER command 
can he issued with no libnames specified. This resets SYSLIB TATLIB as the only 
teat library to be searched, ‘The GLOBAL text libraries reraain in effect until either 
another GLOBAL LOADER command is issued, the LOAD command is issued with 
the LIBE option, the, CMS nucleus is re-initialiized, or the user logs out of CP, 


The second method is by issuing the LOAD conunand with the LIBE option and speci lying 
the text libraries to be used. (See Section 3.2.3). If the file SYSLIB ‘UX TLIB is to be 
scorched along with the user's text libraries, SY5I.1B must be specificd as one of the 
libnames. ‘The LIB! option with the LOAD conumand overrides the effect of the GLOBAT 
LOADER command for that LOAD and any following USE or REUSE commands. 


The third method is by gencrating a SYSLIB TXTLIB file on either the permanent or 
temporary disk. LOAD, USK, and REUSE normally search for the file SYSLIB 
TX'TLIB for missing subroutines. Jn looking for SYSLIB ‘PXTLIB, these commands 
search the permanent disk, the temporary disk, and then the system disk, in that 
order. Ifa user file has the identifier SYSLIB TXTLIB, it will be used in place of 
the system text library. . 
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TAPE FRCCEDURES eee a4 ae 


“A Facility is available for attaching Magnetic tapés to a virtual 


tachine. The selection of a physical tape drive is rade by the CP 


operatce and the virtual device address is chosen by the terminal 


user. The CMS TAPE command requires that the tafe have address 
181. fhe -TAPEIO functicn and the TECCEY ccnmand associate the 
device names TAP? and TAP2 with the device addresses 180 and 181 
respective ye : 


To have a tape attached tc your virtual machine, send a message 
to the CE cperator asking him to mount a tape fcr ycu aS'‘a. 
specified device address. When the tape is mounted and ready for 
use, the syste will autcmatically type the ressage: 


DEVICE xxx ATTACHID 


Since there are cnly a limited number cf tapes available for use 
by CMS user, a user should not keep atape attached te his 
machine any longer than he is using it. Te release a tape from a 
virtnal machine, enter the CE environment and type the CP console 
function: 


DETACH devadd 


When’ a user leqs cut of CP, ali devices ‘are 


attached 
autcmatically detached. 





6.0. 0 


SAMPLE TERMINAL, SESSION 


A sample terminal sessio is given on the following pages. User 
input is in lower case; typeout from the system appears in upper- 
case. The following is a description of the terminal session: 


After logging in to CP and utilizing CMS, a LIST F command is 
issucd to obtain a list of all files stored on user CSCl's permanent 
disk. The file "MAIN FORTRAN" is then created and filed on the 
user's permanent disk, Compilation of the file is terminated due 

to program errors (indicated by a $ symbol below the error cn- 
countered), The file is then modified and edited to correct the line in 
error. and the new source file stored on disk, Again an error 

is encountered and the file re-edited. 


After a successful compilation, the $ command is called to load 
the file into core and execute it, LOAD and START perform the 
esarne function as $, as shown. Specifying the XEQ option with 
LOAD command will also cause execution to bepin after the file 
is loaded, 


LISTE and SRASF opexands are used to selectively list and crase 
files, and the PRINTF command is used to print all and then part 
of the contents of a file, KT causes typeout to be discontinued if 
entered after the attention key is hit twice. 


The OFFLINIS command punches or prints the specified file on 
offline devices. STAT types out statistics regarding the amount 
of disk space used and remaining. The ALTER command changes 
the identifier of a file, KX, entered after hitting the attention 
key twice, stops execution of the current program and returns 
control to CP. 


A new cop of CMS is obtained by issuing the IPL console function 
and an EXEC file (consisting of CMS comimmands) is created and 

filed. The file is then exccuted by issuing the FXPC command, which 
will cause each of the commands contained in the file to be executed 
individually. Operand substitution is illustrated by modifying and 
re-executing the file using & arguments. 


“Hitting the attention key once transfers control to the Control 
Program where the QUERY console functim is issued to determine 
the number of users on the system, their names, and the message 
of the day from the operator. The BEGIN console function then 
returns control to CMS and the user logs out from both CMS and CP, 


Each of the commands illustrated in this terminal scssion is 
discussed in detail in the section dealing with that command. 

_ For a brief description of cach of the CMS commands, refer 
to Appendix A, Command formats and references to the sections 
dealing with each command are given in Appendix B, 


; Sok 
4-12-68 ee. 
6.0. 0-2 ~ 
é : 
CP/6? Online XDh65 Qsyosu ! 
1 csel <4-—----—-—~-——__-—-—-__—. --- Specif our own vid } ; i 
ENTER PASSWORD: aa ae Ren et 


CP WILL 8& UP UNTIL 1500 TODAY. 
RFADY &T 09.55.29 ON 04/12/68 


-~-The protected password does not 
print when entered. 


‘tpl cns 

CMS...VERSION 1.0 - 05/01/68 
listf 

FILENAME FILETYPE MODE NO.REC. 


INDIAN LISTING P1 003 
DUMPREST SYSIN P1 009 
SUPERSGR SYSIN Pl 070 
MY FORTRAN Pl 001 
INDIAN = TEXT PL 002 
FORTCLG EXEC | Pl 001 
LOAD MAP P5003 
DUMPREST SYSUTIL PL 019 
Fin SCRIPT Pl 004 
TUES SCREPT Pl O01 
FRST SCRIPT Pi 001 
DUMPREST LISTING Pl 007 
AGENDA = SCRIPT Pl 002 
TNDLAN FORTRAN Pl 001 a 
R; T=0,06 


edit main fortran | 
FILE DOES NOT EXIST; WILL BE CREATED. 
INPUT: 
c math program April 12, 1968 
write (6,10) 
10#format (' a = ') 
fread (5,20) a 
20fformat (8.3) 
fwrite (6,25) a,x 


fend 
se aaa a Null line typed to transfer to Edit 
EDUT: environment. 
file 
R; T#0,11_ 
fortran matin ° 
0004 20 FORMAT (8.3) 


COMPILATION CANCELLED NUF TO SOURCE PROGRAM FRROR(S). 


£(00032); 


$ 
01) ERR 13 SYNTAX 


2 


T=0.32 
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edit inain fortran. 
EDIT: 
p 20 


C MATH PROGKAI APRIL 12, 1968 
whITE (6,10) 2 
lu FORMAT (' Ae ©) 
READ (5,20) A 
20 FORMAT (8.3) 
WRITE (6,25) A,X , A 
END : : 
EOF REACHED BY: | 
P 20 
1 /fornmat/ 
lu FoRmaaTt (' A = ny 
1 /format/ 


20 FureinT €8.3) ; ‘ 
ce /8/f8/ | 
Zu FuRiiaT (F@.3) 
u 2 
lu FURKAT (' woe ') 
Cf ts 07 
10 FORMAT (' a = 2?!) 
f 20 
2U FUMNAT (F&.3) . 
i o*x = arx2 : 
ELIT: 
12 
X = Aer? : iy 
t 
p 20 


C MATH PROGKAH APRIL 12, 1968 
WRITE (6,10) 

10 FORMAT (C' an = 2!) 
ReEAv (5,20) A 

20 FORMAT (CFS.5) 
X Bio nee? 
WhETE (6,25) wa 

END 

EQF REACHED BY: 

P 20 

file 

Kz; Te0.51 


fortran main ° 
ERR 22 UNDEFINED LABEL 
25 
VULMPILATIGN CANCELLED DUE TO SOURCE PRUGRAM ERRUR(S), 
£(00032);. T=0.40 


7 4-12-68 
6.0,0-4 
558 
edit main. fortran . 
EDIT: i 
1 /25/ 
WRITE (6,25) A,X 

1 25#format (' a = '€8.3," x = 20.3) 
p : 
25 FORMAT. (’ A = 'F8.3," X @ 20.3) 
c /20/' f20/ 
25 FORMAT (' A = 'F8.3,' X = ' F20.3) 
file ; 
R; T#0,14 
$ ma¢ <j. The ¢ deletes the line, 


fortran matn 
Rz Ts0.46 


$ matn 

EXECUTION BEGINS... 

A.® ? 

2.5 

AS 2,500 % = 6.250 


Ry T#U.33 


load main 
R; T=0.25 


start 

EXECUTION BEGINS... 
A = ? 

3.1 


R; T#0,05 


Yoad iain (xeq) 
EXECUTION BEGINS... 
A*® ? 

A 3.200 X = 10.240 
R; T=0.28 


listf main * 
FILEWANE FILETYPE MOGE NO.REC, 


MATH: LISTING Pl 003 
MAEN- §  FORTRAH PL 001 
MALIN TEXT Pl 002 
R; T=0.03 


listf * listing 

FILENAME FILETYPE MODE NO.REC. 
INDIAN LISTING Pl 003 
HATR LISTING P21 003 
DUMPREST LISTING Pl 007 

Rs Ts0.01 


erase * Tisting 
R; TeO,03 : 


listf * Tisting 
FILE NOT FOUND 
E(vugud2); T#0.03 


A= 3,100 X= 9.610 


t $ 
\ 


printf main fortran 


& ilabe PRUGRAG  APREL 12, 1968 

WkITE (0,10) 
“io FOoRKHAT (' a & 2%) 

RiAuv (5,20) A 
20 FORMAT (F823) 

hw = AtRQ ‘ 
: “WKETE (6,25) A,A 
25 FORMAT (' ae 'F8.3," A = ' F20,3) 


- END 
RK; T=0.06 
printf iain fortran * 3 25 
G GALA PROGRAM «= APRIL 12 
7 WwRETE (6,19) 
lo Format (' A = 2!) 
ra he T=U.04 


printf main Fortran 


7 OAD Giesbua PROGRAM APRIL 12, 1968 
white (6,10) 

= ly " <j ---. 

kt 

fh; T=0.Ub 


offline punch main textcdudfortran 
ne T20.07 


offline print main fortran 
BR; T20.0u 


offline printee nain listing 
File WOT FOULRD 
e(V0002); T=0.02 


listf 

FILEGARME FILETYPE mobE NOREC. 
LUPREST sYola Fl 0u9 P 
SUPERSUR SYST Pd u7uU 
il , FORTKAN Pl 001 
FURTCLa EAEU © Pi 001 
LuAab iaP Pb v5 
atadal FURTRAH hl uGl 
LUEPLEST SYSUT} pl uly 
vb nEST SYSUT2 Fl 019 
Fla. SphiPT Pl vol 
PLES SCREPT Pl b01 
FRST SCKIPT Pl 001 


vUMPREST sYouT3 vl 001 
Se AULHDA SCRIPT Pl vil 
: pelaa TERT pl 02 
hy Td.05 
= stat 

- PrulSie 

- hy Teu.G2 


ial = 


hag 
zr 


The ATTN key was hit twice to 


enter KT for killing the typeout. 


G1H2 KECUKDS Bd USE, 0258 LEFT (of 0400), 3uy FULL Cof 010 CYL.) 


4.12-68 
: 6,0,0-6 
S(t 
. , re GU 
alter main fortran * mainone . * . 
Rz; T=0.02 2 


listf main fortran 
FILE NOT FOUND 
£(00002); T=0.03 


listf * fortran 

FILENAME FILETYPE MODE HO.REC. 
ily FORTRAN Pl vol 
WALHONE FORTRAN Pi 001 


Liu dAN FORTRAN P1 O01 
k; T=0.01 
S main The ATTN key was hit twice to enter 
| = . " KX for killing execution of §. 
« 
kx 


KILLidu CHS EXECUTION... ; 
peviSk: 0142 RECORDS IN USE, 0258 LEFT (of U40G), 36% FULL Cof Olu CYL.) 
TOTAL CPU-TIME CIN SECONDS) = 11.16 ; 
UP ENTERED, READY. 


ipl cus 
CHS... VERSTOM 4.0 - 04/01/68 


listf mainonnge * + Tac @ deletes one character. 


FUELENAWE FILETYPE MODE NO.REC,. 
HATHONE FORTRAN PL 001 
Kk; T=0,03 


edit fortclgo exec 7 
FILE DOES WOT EXIST; WILL GE CREATED. 
INPUT: 

fortran mainone ; 

$@load mainone (xeq) 


EDIT: 
file 
R; T=0.10 


printf fortclgo exec 


FORTRAN TATHOME 
LUAD Mab NuinE CKEQ) 


Ky; T=0.04 


exec fortclzgo 

-FORTRAH HALNGNE 

LUAD WAINUNE (XEQ) 

EXECUTION BEGINS... - 
A = ? : seh 
3.4 ‘ 

AO 3.400 X & 

R; T2=0.86 ? 





4-14-68 
edit fortclgo exce i 6.0,0-7 
LDIT: : . SECS 


c /mainone/ &l/ * g 
FORTRAN al 

LOAD G1 (XE) 
EOF REACHED BY: 

C /MALNHUNE/ &1/ * 
file “ 
Ry T20.11 


Cc. 


exec fortclg9o ma'none 
FORTRAN HAITNUHE 

LUAU HWALHONE (XEQ) 
EXECUTION BEGINS... 

A = 7? 
5.1 

AF 5.100 X = 26.010 
R; T=O0.89 


edit fortcelgo exec 

EDIT: 

} &set err exit 

po , 

SSET ERR EXIT 

FORTRAN al 

LUAD &1 CXEG) 

EGF RLACHED LY: 

PY : 
file 

kK; T=0,11 ’ 


edit mainone fortran 
cuUIT: ; 
p & 


GC HATH PROURAL APRIL 12, 1908 
WkITE (o,10) 

10 FORMAT (f ae 2") 

b aa 
FoREAT (A = 2°) 

flle badone 

Ky Teu.15 


listf * ‘fortran 

FibLiwaié FILETYPE MODE wu. rec, 
uy FURTIAN Pl vl 
rabid  FORTRALR Pl OUl 
LdDTAN FORTRAI Pl 001 
DADONL FORTRAN pl O01 

Hy. T=u.03 


exec fortclzo badone 
FURTRAW BADONE 
0062 _ FORMAT (C' AF 7") 


; > 
01) ERR O02) LABEL 
CUMPILATION CANCELLED DUE TO SGURCE PROGRAM ERRORS). 
rr) £(00052) T!t 
ky T=G,48 


pips Sadia eteenonmatbest gt tascdaets a Ae iy Ct es i: a fa ites RR ys SEN AY OnE RE ONS DR IE ty PRE 


- 
- P 
ed 4-12-68 
edit fortclgo exec : : 6.0. 0-8 
EDIT: 


& 


c /&1/&1 &2 &3 &h &S/ * g 
FORTRAN al &2 &3 &h &§ 
LOAD &1 &2 &3 && &5 (XEQ) 
EOF REACHED BY: 

C /&1/81 &2 &3 && &5/ * G 
file 

Re. T#0.12 


exec mefortelgo malnone 

FORTRAN MATNONE 

LOAD MALNUNE (XEQ) 

EXECUTION BEGINS... 

‘AF 2. 

1.9 

A ® > 1.900 XK * hou BL 610 


Rg T#0,93 


<j———--- 





q user 
10 USERS 


q user names 
CURREHT USERS ARE... 
MADNICK ON 029 
MARK OW O4L 
MEYER UN 047 
OPERATOR UN 009 
BAYLES OH O49 
CJUONES OW 620 
RUSATU Un 027 


Wd ON 024 
SEYMOUR ON 045 
ree ON 028. 


q logmsg : 
CP MILL BE UP UNTIL 1500 CONTINUOUSLY... 


begin peachy 4 Se 7 

cae < ——--=<~ BEGIN returns control to CMS, 
logoug ; 

INVALID CMS. COMMAND 


logout 

CHS LOGGING OUT... 

TOTAL CPU~TIME CIN SECONDS) = 2,99 
CP ENTERED, READY, 


} 
LOGOFF AT 12.06.06 ON 04/12/68 
it 


CP/67 Online XDh65 Usyosu 


__ The ATTN key was hit once to enter CP, 


LF 
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CMS Batch Monitor 


A Batch Monitor for running Express type jobs has been implemented 
and cun be run from a terminal along with other conversational CMS 
users, The Batch’Monitor permits a user to compile routines using 

the FORTRAN-G compiler and/or translate Assembly language programs 
using the ASSEMBLER-F translator, Programs can be selectively 
assembled or compiled and then executed. Temporary work files 
referred to as FORTRAN logical files are stored on disk and should 


‘be of limited size, The Batch Monitor's perrnanent disk is erased 


and CMS is re-ipled whenever a JOB card is processed, 


A CMS Batch Job 

Source, object, or data cards included in the job stream are stored as 
separate CMS files, Mach file is identified by a filenarne and a filetype, 
FORTRAN, ASSEMBLY, and TEXT control cards indicate that the filetype 
should be FORTRAN, SYSIN, and TEXT respectively, Unless specified, 
the filename will be chosen by the system. 


When a FORTRAN file is compiled or.a SYSIN file is assembled, an 
object module is pencrated as a file witha filetype of TIEXT and a 
filenamg the same as the filenaine of the source file, Data files to be 
read as a FORTRAN logical unit, must be identified as FILE FTOnrd0ol 
where nis 1, 2,3,4,7, or 8. Files created by writing-on one. of 
the above FORTRAN logical units will be identificd in the sarne way. 
These files may be PRINTed or PUNCHed using the appropriate control 
card and specifying the filename and filetype, 


Execution of object modules (TEXT files) is initiated by the GO contra) 
card, ‘his contro) card causes all TIEX'T files to be loaded into core. 
Execution is began at the entay point specified in the GO.control card or, 
if defaulted, at the first program encountered in the joh stream, If 


during the exccution of a program: a propram intexruption occurs, the 


programmer will pet a complete core dump and the job will be terminated, 
Data cards folowing the GO control card can be rcad as FORTRAN logical 
unit 5 (sysin), Any data cards following the GO control card which are not 
read will be ignored, An example of a CMS Batch job deck is shown in 
Figure 7,1,0-A. 
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CMS Batch Control Cards 


A deck to be submitted for CMS Batch must have an OS/360 standard 
job card with a programmer's name specified at the beginning of the 
deck, The control cards for CMS Batch specify a procedure name 
topether wich optional parameters, Control cards must have / / in 
columns 1 and 2 and column 3 must be blank. Procedure names and 
parameters are each separated by one or more spaces. The CMS 
Batch control cards are listed in Figure 7,2, 0-A and are described 
in subsequent. sections, To simplify the transition from an 05/360 
job to a CMS Batch job, selected OS/360 control cards are transJated 


‘into CMS Batch control cards to perform the corresponding functions. 


The OS/360 procedures names which are recognized and the CMS 
Batch control cards they are eqtivalent to are specified below: 


0S/360 procedure names 


CMS Batch control cards’ 





FORTRAN // FORTRAN 
LARGFORT /[/ FORTRAN 
JINKIWDIT // TEXT * 
LINKOLI // 'SEXT 
LINKSRC Vf VuUxXe 
EXECUTE // GO 
DISKEXEC 1/ Go. 
ASSEMBLE // ASSEMBLE 
ASEMLINK // ASSEMBLE 
PUNCH // PUNCH 
“TPpPCHnoBs // PUNCH 


Note: 
The only OS/360 // EXEC cards that are recognized by CMS Batch are 


the ones specified above; all other OS5/360 control cards are ignored, 
Also, only one job step per procedure call is allowed, . 


eae etaon Siipsnte petra etaceracamntrean ei  tttE O t tee A 


i] 


if 


~— se 
ae ee 


i] 


~~ 
~~ 


ff 


‘] 


Standard Job Card 
Standard Name Card 
FORTRAN 


e 
Fortran Program ] Source Cede 


END 


Fortran Program 2 Source Code 


END 
ASSEMBLE ABLE 


Assembly Program 1] Source Code 


END 


Assembly Program 2 Source Code 
END 

PUNCH ABLE 

TEXT 


Object Module 


Go 


Data Cards 


* 


PRINT FILE FTOMF O00) 
ASSEMBLE ABLE NOLIST 


Second Version of Assembly Program ABLE 
END 
DATASET FILE FT02F001 


Data Cards 


GO ABLE 


Figure 7.1.0-A, Sample CMS Batch Stream , 
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RENT J 
NOREN?| 





a 


TEST team ORS a 


omer, 
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L. 
* pte NCLIST 
ye // ASSEMBLE filename List | | XRF 
| i. ag NCXR 
35 // TEXT | I 
4.. // DATASET filename filetype 
/] GO entry point 
idefault entry point 
6. // PUNCH filename | fe 
| ~~ | TEXT 
7. // PRINT prierane filetype : 
8. // LINK userid devadd | password | 
9. ff RETURN filename filetype 
Figure 7.2.0-A. CMS Eatch Control Cards ; 


// FORTRAN = jrap | | List 
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7.2,1-) 

; ~  -» -f - FORTRAN 
7.2.1, / / FORTRAN . . 567 
Format: 

/ 1 FORTRAN filename, MAP LIST -BCD 

z NOMAP] |NOLIST] | EBCDIC 

filename “specifies the name of the file which will contain ’ 
the cards following the //FORTRAN control 
card up to the next control card. The filetype 
will be FORTRAN, 

* If no parameters are specified, a filename will be 
chosen by the system and the default options will 
be ‘taken, 

‘ 

MAP * Includes tables of addresses of FORTRAN variables, 
in the LISTING file. 

NOMAP Suppresses the tables of variables. 

LIS? Includes a listing of object codes in assembly language 
mnemonics in the LISTING file, 

NOLIST Suppresses the object code listing. 

BCD Causes the source program to be interpreted werng 
the Binary Coded Decimal code, 

EBCDIC Causes the source program to be interpreted using 
the Extended Binary Coded Decimal Interchange Code, 

Usage: 


All cards following the / /FORTRAN control card and up to the next control 
‘card will be assumed to be FORTRAN source code, These cards will be read 
and stored as a file and will be compiled using the FORTRAN-G compiler under 
the specified or defaulted options. The source cards may contain any number 
of routines each delimited by an END statement. If a filename is specified, 

the source cards wil) be stored as a file with this filename and filetype of 
FORTRAN. If filenarne is not specified, the system will choose a unique 

name. The options specified govern the compilation of the following source 
cards. Any combination of options may be specified in any order. If an 

option is not specified, the underlined default choice is assumed, 


11/01/68 wad 
SbF a, Te a 
/ / FORTRAN 


A compilation will result in a LISTING and a TEXT file being generated. 
- The LISTING file will be automatically written out on sysout.. The TEXT file, 


i.e., object modules, can be punched using a / /PUNCH control card. The 
filename of the TEXT file will be the same as the filename of the FORTRAN 
source file, 


Object modules, i.e., TEXT files, will be loaded into core and exccuted 
when the / / GO control card is specified. 


Output: 


If MAP is specified, a table of addresses is generated for cach of seven 
classifications of variables used in the source program. ‘The classifi- 
cations are COMMON, EQUIVALENCE, NAMELIST, FORMAT, scalar 
variables, array variables, and called subprogram names. 

i) 


If LIST is specified, a listing of the object progxam is gencrated with 
relative addresses and instructions translated into assembly language. 


Diagnostic and error messages produced by the compiler are placed in 
the LISTING file and will be printed on sysout. 


a. Source cards can be punched in either Binary Coded Decimal (BCD) ccde, _ 
or Extended Binary Coded Decimal Interchange Code (EBCDIC). If the BCD > 
code is used, the BCD option must be specified for the compilation. 


b. The entry point for the first main program will be the same as the 
filename. Subsequent main programs will have the entry point MAIN, 
The entry point for subroutines, are specified in the SUBROUTINE statement. 


c. Data can be read frorn sysin using FORTRAN logical unit 5 and written 
onto sysout using FORTRAN logical unit 6. 


da Only FORTRAN logical units 1-8 may be uscd. The FORTRAN logical 
‘files arc defined as follows: 


Logical Files Record Length _ 
1-4 80 character records 
5 80 character sysin records 
6 130 character sysout records 
7 80 character records 
8 133 character records with carriage control 


VLA a 
567 EY, 


Sa dE 
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a 7, 21-3 | LO pore} 
| : | | FORTRAN » * / { ASSEMBLE 
7.2.2 | | ASSEMBLE 
e. An ID consisting of four characters is punched in colurnns 73-76 Posnat: 
‘of object decks (TEXT files) and is followed by a sequence number in — 
column 77-80. For a subroutine, saree is ae ibe ” : 1 1 ASSEMBLE Bt aac cads cae ta [ sian 
four letters of the subroutine name. For a main gram, the : 5 : Oxia | ! IRN" 
ferme’ from the first four letters of the filename if it is the first deck a NOLIST) |NOXARI4 Nene 
‘ s . igchs . % / = 
in the file, otherwise, an ID of 'MAIN' will be used. ; filename specifies the name of the file which will contain the 
cards following the / / ASSI7M}3LE control card up 
References: to the next control card. The filetype will be SYSIN. 
i the FORTRAN IV language, see IBM System/360: . ; a oe en . 
FORTRAN IV LANGUAGE, Form C28.6515, and FORTRAN IV Library, SL a Ue ae ets EAD nae et ees aan 
Subprograms, Form C28-6596, For information on compiler operation ane y the system and the default options wit) be 
. and messages, sec, FORTRAN IV (G) Programmer's Soe ss oa | , | | 
E iH in the Programmer's Guide on Operating System jo contro : ee: td 
ew ae scahegement Te hot ap! Ts not applicable under CMS. The LOAD, HoMst NOLIST suppresses c: cavion of the LISTING file. 
NAME=, and LINECNT=options are not supported. S 
; ° XREF NOXREF suppresses creation of the cross-reference 
NOXREF symbol table within the LISTING file. This option is 
ignored if NOLIST is ‘specified. 
RENT RENT causes the assembler to gencrate messages in 
; NORENT the LISTING file if non-reentrant coding is found in 
: ‘ the assembled program. -. 
Usage: ~ 


All cards following the / /ASSEMBLE control card and up to the next control 
card will be assumed to be Assembly Language source code. These cards 

- 7 will be read and stored as a file and will be translated using the F-level 

, Assembler and the specified or defaulted options. The source cards may 

contain any number of routines, each delimited by an END statement. Ifa 
filename is specified, the source cards will be stored as a file with this 
filename and filetype of SYSIN. If filename is not specified, the system 
will choose a unique name. The options specified govern the translation of 
‘the following source cards. Any combination of options may be specified 
in any order. If an option is not specified, the underlined default choice 
is assumed. . 


An assembly will result in a LISTING and a TEXT filé being generated. The 
LISTING file will be automatically written out on sysout. The TEXT file, i.c., 
; object module, can be punched using a / / PUNCH control card. The filenarne 
’ of the TEXT file will be the same as the filename of the Assembly Language 
source file. 
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T} ASSEMBLE 


Object modules, i.e., TEXT files, will be loaded into core 
and executed when the / /GO control card is specified. 


Output; 


. 


If LIST is specified, or defaulted, a listing of the assembled 
machine-language code together with the source statements 
and an external symbol directory is generated, 


If XREF is specified, or defaulted, a cross-reference symbol 
_ table will be included with the generated listing. 


If RENT is specified, messages will be included in the listing 
if non-reentrant coding is found in the assembled program, 


Diagnostic and error messages will appear at the end of the 


listing. 


Notes; 


a. The assembler searches the system macro library (SYSLIB 


MACLIS) for macro definitions, 
in this Jibrary are shown in Figure 7.2.1-A, Additional macros 


Names of the. macros included 


may be included with the source program. 


References: 


For information on the Assembly Language, see JBM 0OS/360 
Assembler Language, Form €28-6514 and Assembler FE 
Programmer's Guide, Form C28-6595, For information on 





the basic 360 machine, see IBM System/360 Principles of 


Operation, Form A22-682), 


Lief 


CMSTYPE 
CMSAVE 
CMSREG 
MADCALL 
MADDPL 
MADTYPE 
CMSYSREF 
FINIS 
RDBUF 
GEN 

TYPE 

FCB 
STATE, 
CKEOF 
RDTYP 
WRBUF 
SETUP 
ERASE 

TY PIN 
WAITR 
RDIFCB 
CILOSE 
DCB 

DCB) 
¥FREEMAIN 
GET 


FREE POOL 


GETMAIN 
GE'TPOOL 
LINK 


Figure 7,2, 1-A, 
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OPEN 

PUT 

READ 
SAVE 

SPIE 

TIME 

WAIT 
WRITE 
WTO 
WTOR 
INBRDWRD 
IHBRDWRT 


JHBQL 


INBINNRA 
IHBERMAC 
IHNBRRPWRK 
IHBRDWRS 
IHBOPLST 
IHBINNRB 
NOTE 
XCTL 
CHICK 
ABEND 
FIND 
POINT 
PUTX 
RETURN 
F DIMEN 
BSP . 


Assembler Languages Macros 


; 11/01/68 3239 | ; 


; %. 2, 3-1 
// TEXT 11/01/68 24 
53 ie 7.2,4-1 
: . O73 : -f | DATASiEY 
8.2.3. // TEXT . | , STH. 
eee , 7.2.4 1 / DATASET 
at; 
; : . Format! : . 
// TEXT : ——— ‘ 
/ / DATASET filename filetype : 
Usage: 
SEES filename filctype specifies the identifier to be given 
The cards following the / / TEXT control card and up to the of Fina iag ainey eer 
next control card will be read and stored as a file. A unique eonteol card ts ts theHext control. 
filename will be chosen by the system and the filetype will be card, 
Example: 
as : The cards following the / /DATASIST control card and up to the next control 
// TEXT card will be read and stored as a file. If the file identifies FILE FTOnF001 
when nie 1, 2, 3, 4, 7, or 8, the file can be read as a FORTRAN logical 
unit. : . 
5 7 ; , Example: 


‘ / / DATASET FILE FTO1FO001 


2 





11/01/68 34 
, 7.2.51 0 
_ /./ GO 
7.2.5 / 1 GO : - 4 . S75 
Format: | 
// Go... entry point 
default entry point 
entry point ’ specifies the name of a control section or entry 
; point to which control will be passed at.execution time. 
default’ entry point the default entry point is the beginning of the first 
a Program encountered in the job stream. 
Usage: 


This control card causes all TEXT files to be loaded into core together with the 
required modules from the system library SYSLIB TXTLIB,, The proper 
linkages are established between the program modules. Programs are 

loaded at X'12000' and many extend up to X'3ND000!, : 


‘A load map wil) be created containing the location of control sections and 
entry points of the programms loadcd and will be printed on sysout. After 
loading is completed, exccution will be begun by transferring control to 
either the entry point specified or to the default entry point. 


Data cards following the / /GO control card can be read from FORTRAN 
programs using logical unit 5. Data cards not read will be ignored. Output 
written onto FORTRAN logical unit 6 will be written onto sysout and will be 
printed. 

Note: 
An "entry point!” rust be cither a control section name or an entry point. 


name. It may not be a filename if the filename is not identical to cither a 
control section narne or an entry point name. : 


Examples: 
a. // GO Q 
b.  // GOENTRY) | 
Error Messages: 
E(00001), DEFINEDMORE THAN ONCE - xxxxxxxx 


E(00002) OVERLAY ERROR . 
The files being loaded have run out of core. 
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/1/GQ | 
SIE 


00003 REFERENCE TABLE OVERFLOW 
‘ pee are too many entries for the entry points or control section 
names in the reference table that is )uilt during loading. 


(00004) THE FOLLOWING NAMES ARE UNDEFINED ~ xxxxxxxx 
The names xxxxxxxx are referred toin a file and have never been 


defined. 


£(00005) NAME IS UNDEFINED ~- xxxxxxxx ; ; 
The name xxxxxxxx specified as an entry point does not exist. 


S77 BOR 


11/01/68 
7,2. 6=1 
/ / PUNCH 


7.2.6 // PUNCH 
Format: ~ : ~j 


filetype 


filenamé 
; TEXT 


/ | PUNCH * 


filename filetype the identifier of the file to be punched. 


* indicates that all TEXT files are to be punched. 


Usage: . 


Files with records up to 80 characters in length will be punched into’ an 
80 column card. 


Examples: 


a. / | PUNCH. 
All FEXT files will be punched. 


b. / / PUNCH PROG) 
i The file PROG] TEXT will be punched. 


c. / / PUNCH FILE FTOIFOO] | 
The FORTRAN logical file 1 will be punched. 


Error Message? 
E(00002) ° FILE NOT FOUND. 


ca) 








_ 3 ait 
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: / ¢ PRINT 

7.2.7 | [| PRINT S7e 
Format: _ 

/ 7) PRINT filename filetype 

filename filetype specifies the name of the file to be printed 

on sysout, 

Usage: 


Each line of the specified file is truncated to 130 characters and printed 
on sysout. The first character of each line of LISTING file is not typed 
and is used as a printer carriage control character, 


The carriage control characters are interpreted as follows: 


Character EBCDIC Action_ 
ee. ag 40 print line and space 1 
"on FO space 1, print line, and space 1 
yu : Fl skip to new page, print line, and cities 1 
xx any other character is used as a CCW 


command code. 
Example! 
/ / PRINT FILE FTOJFOO! 
Error Message: 
(00003): FILE NOT FOUND, 





7.2.8 // 


Format: 


userid 


devadd 


password 


Usage: 


Notes: 


won ten go om ie go 


7.2.6-1 
AP LISK 


LINK 


// LINK userid devadd password 

is the owner of the device to be LINKed to 

is the virtual device address of the disk 

is the read-share password of the disk 

This control card enables the Batch Monitor. to 
access files on a disk which can be LINKed to 
with read-share privileges. The types of files 


which can be handles in this manner are FORTRAN, 
SYSIN, and TEXT files, and Fortran logical files 


_ (FILE FTxxfyyy). Instead of having to send 


large files: to the Batch machine, the user can . 
send a small deck of control ecards. The file © me 
which contains the control cards must have 

filetype, RJE, | 


a. ° The owner of the library disk to be 


LiNKed to must a have the disk in 
write status. If the Eatch machine is 
unable to (LINK to the disk in question, 


the user's job is deleted and must be 


re-subpmitted, A 
b.  ~<JIf£ the // LINK control card is used, 
Batch will attempt to access all SCNRTRAL, : 
SYSIN, TEXT, and Fortran logical files from 
: ? 3 ro) 
the library disk. 
: | 
( 
c.: If the library disk has no password, 
substitute the word, ALL, in place of 


password. 


appt ee eee eee ems sete 


‘ 
te cee ee efie eters 
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7.2.8-2 
// LINK 
_ Examples: ; 
1. // JOB 


// NAME TRYVTS99 
ff LISK TRYVIS99 291 ALL 
ff FORTRAN GENREP © 
ff TEXT SUERT1 
// TEXT SUERT2 
- f/f GO 
fk 


Batch LINKs to TRYVIS99's 291 with a password of "ALL", 
L.e., NOPASS. Batch attempts to access GENREP FORTRAN, 
SUBRTL TEXT, and SUBRT2 TEXT. It compiles GENREP, loads 
-the three TEXT files, and executes. 


. «+ f/ NAME TRYVTS88 
// LINK TRYVISSS 191.TY8 
// FCRTRAN ILDEC 
// DATASET FILE FIO2FOOL 


{{ GO 

// PRINT FILE FIO4TOO1 

/[* 
ILDEC FCRTPAN and FILE FT 02F002 are sheadaea from the 
Pedisk (191) of TeYViS&8. ILDEC is compiled and executed, 
and its ei ae file, FILE FTO4TO01 is printed on the 
high-speed printer, 


spe 
é 


Error Messeces: None. 


7.2.9 // RETURN 


Format: 


filename filetype 


Notes: . 


Examples: 
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// RETURN 


e* 


// RETURN filename filetype 
identifier of the file to be 


returned to the user 


Cutput as the result of a Batch job can be 
returned to the user at the termination of 


‘his job. A // RETURN card must be included 


in the job stream for each file the user 
wishes to have sent to his machine. The 


returned decks are in DISK DUMP format. 


a. The returned files are XFE ERed to the 
USERID which appears on the // 
NAME card. 7 
4h. Tf JOB 


// NAME TRYVTS99. 
// FCRTRAN GRAPH. 
DIMENSION X(100), Y(100) 


END 
[1 G& , 
// RETURN GPAPH LI 
// RETURN FILE FY03 


na 


The records between the FOPTRAN and GO cards 


are compiled as file, GRAPH. The resulting 


text is executed; GRAPH LISTING and FILE 
FTO3FCOl are DISK DUuPed to TRYVIS99. 


Le; avf/o¥ 
722.9-2 : 
// RETURN - 


2. ff JOB 
_ f/f NAME VISUSER 
// LINK VISUSER 191 PSUD 
7 // ASSEABLE SCRTINE 
: . ff RETURN SORTINE. TEXT 
fee 
VISUSER's P-disk is used as a library disk. : 


SORTINE is assembled, and the text is-returned 
to VISUSER. | 


Pg, neem ea ob 
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bBE 
7.3.0 Running CMS Batch 
CMS Batch accepts an input stream from either the card reader or tape. 


The punched output can go to tape or directly to cards and the printer output 
can go to-tape or the printer. The tape assignments are as follows: 


symbolic virtual 

address _ address contents track : 
TAPS 184 SYSIN 9 
TAPS 185 SYSOUT 9 
TAP 186 PUNCH 9 | 


If the SYSIN tape is not attached to the BATCH machine, the system will 
assume that the input stream will come directly from the card reader. If 
the PUNCH tape is not attached, the system will write the PUNCHed output 
directly to the online punch, If the SYSOUT tape is not attached, the printer 
will be uscd. : 


The tapes used are unlabeled ones. The SYSIN tape consists of unblocked 
card images. The PUNCII tape also consists of unblocked card images but 
each job consists of = separate file, where the first record of each file contains 
thd job nurnber and the programmer's name, The SYSOUT print tape consists 
of unblocked 133 character records, 


Each job is limited to 4 minutes of execution time and 5000 lines of printer 
output. . 


To run the GMS BATCH stream, 


a) JOGIN to CP as the BATCH user 
b) IPL the Batch Monitor's Nucleus 


and the batch stream is started automatically. To initiate another 
job stream, IPL the Batch Monitor's nucleus each time. 


Messages will be printed on the BATCH user's console indicating: 


‘a) the job number being run 
b) a request ta mount a new SYSOUT or PUNCH tape 
c) the userid of the jobs which have PUNCH output 


During the running of the Batch machine, the operator may cancel a job or 
request that the Batch monitor pause after the end of the current job so that the 
operator may modify a system parameter. To interrupt the running of the Batch 
monitor, the Attention Key should be pressed to enter CP. Storage location 
X'4C!' can then be rnodified to indicate the action desired. An external interrupt 
to the Batch monitor will then cause location X'4C' to be examincd and appropriate 
action taken. The byte at location X'4C' has the following rneaning: 


: : 11-01-68. : fs 
7.3.0-2 oy 32 


od 


X'00' cancel current job without a dump (default value) 
X'01' cancel current job with a dump , 
X'02' pause at end of current job. 


For example, to set code } in location X'AC! a:.d return to the Batch monito., 
press the Attention key and type: 


"$T L4c } 
E 
B 
When a job is cancelled by the operator, a message is written on SYSOUT 
to indicate to the programmer what action was taken, The following messages 
may be printed on the programmer's output. 


TIME LIMIT EXCEEDED 

The running time of the job exceeded 240 seconds (4 minutes). 
OUTPUT LIMIT EXCEEDED 

The ndmaber of lines of output is limited to 5000, 
CANCELLED BY OPERATOR. 


The operator can cancel a job either with or without a core dump. 
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GLOSSARY OF TERMS 


Terms with specific meanings in CP and CMS are described below 
in alphabetical order, For the definition of any term not appearing in this 
Glossary, refer to the first page number given for that term in the index, 


ACTIVE FILE TABLE: a table residing in the user's copy of the CMS nucleus 
which contains an entry for each of that user's currently opened files (up 
to a maximum of eight). 


ARGUMENT: any alphanumeric information, not exceeding eight bytes in length, 
the address of which is to be passed to a program at the time it begins 
executing or to a CMS command. 


ATTENTION INTERRUPT: a signal to the system which will effect a transfer of 
contro] hetween the Control Program and other environments, The terminal 
keyboard will be unlocked, regardless of current processing, and the input 
line will be processed by the environment which has control. 


ATTENTION KEY; a key on the terminal keyboard which, when hit, causes 
an attention interrupt, This key is labeled ATTN on the 2741, and RESET 
LINE on the 1050, 


CARD IMAGE: an 80-character logical record. in which each 
character corresponds positionally to the columns of a punched card, 


CARRIAGE RETURN: the signal which indicates to the system the termination 
of a line of input from the terminal, This signal is transmitted on the 2741 
by hitting the key Jabeled RETURN; on the 1050, it is transmitted either 
by holding down the ALTN CODING key while hitting the 5 key, or (if 


the 1050 is equipped with the Automatic EOB special feature) by hitting the 
RETURN key. . 


CHARACTER-DELETE SYMBOL: a character appearing on the terminal key - 
board which, when hit n times, will delete the preceding n characters 
and itself from the input line. Currently defined as the @ character, 


CMS FUNCTION: a routine available to the GMS command programs for the 
handling of internal processing, such as accessing and updating disk file 
directories or handling disk and terminal I/O, 


CMS NUCLEUS; the core-resident portion of CMS of which each user receives 
a copy at the time he issues an IPL 190 console function. 


~ ty J 
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CONSOLE FUNCTION: a software facility whereby the user, at his terminal, 
can simulate a function he would normally be able to perform at a 360 
console. The command facilities of the Control Program are referred to 

- collectively as CP console functions. 


CONTROL SECTION: a block of coding that can be relocated, independent 
of other coding, without altering or imparing the operating logic of the 
other coding, 


CP/CMS SYSTEM: a time sharing system in which the Cambridge Monitor 
System (CMS) runs as the operating system of a virtual machine created 
by the Control Program (CP). 


-CPU TIME: the period of time during which the central processing unit of the 


computer is actively engaged in the processing of instructions. 


DEFAULT ENTRY POINT: the core location at which execution will begin 


if no starting location is specified; either that given in the first non blank 
operand of an END card image or, if a]] END operands are blank, the 
beginning of the first labeled control section of the loaded program(s), 


ENTRY POINT: any symbol in a control section which can be used. by other 
control sections to effect a branch operation or a data reference, 


ENVIRONMENT; ‘that portion of the CP/CMS system which has control at the 
time an input line is transmitted from the terminal, and which processes 


that input line to determine its acceptability. Only a subset of all possible 
input is acceptable in any given environment. 


ERROR MESSAGE: the message "E(xxxxx); T= xx, xx", where xxxxx is the 
error code returned in general purpose register 15 and xx. xx is the CPU 
time in seconds used since the last Ready or error message, Any in- 
formation typcd at the terminal which explains the meaning of the error 

. code may also be considered part of the error message, 


FILE DIRECTORY: a table for each disk file storage area which indicates 
the file identifier, file size, and location of each file stored in that area. 
For example, the system file directory contains information for cach file 
stored on the system disk, 

FILE IDENTIFIER: a three-part designation which uniquely identifics each 
file stored on the permanent, temporary, and system disks. This identi- 
fiex consists of a filename (any descriptive terrn), a filetype (indicating 
file contents), and a filemode (indicating file location). 


-_, 


~—~ 
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INPUT LINE; all information, up to a maximum of 130 characters in length, 
typed by a user between the time the typing element of his terminal comes to 
rest following a carriage return until another carriage return is issued. 


LINE-DELETE SYMBOL: a character appearing on the terminal keyboard 
which, when hit, will delete all preceding characters in the input line 
and itself, Cutrently defined as the ¢ character. 


LINKAGE: the resolving of external references between control sections at 
load time, 


LOAD MAP: a file containing the core locations of control sections and 
entry points of programs loaded into core, 


MAGRO LIBRARY: a disk file (whose filetype is MACLIB) containing macro 
definitions in'assembler language source code and a dictionary of the 
name, size, and location of cach macro definition within the file. 


NULL LINE: an input line consisting of a carriage return issued as the first 
and only information after the typing element of the terminal has come to 
rest following a previous carwiage return, 


OFFLINE DEVICE: a device whose 1/0 is temporarily stored in a spooling 
area by the Control Program; namely, the card reader, printer, and card 
punch. : : 


ONLINE: any operation performed at a terminal which is actively connected to 
the computer. 


OPERAND: any field, delimited by one or more blanks, which may be specified 
in a command, request, or console function. The operands are distinct 
from the command, request, or console function name, which is always 
the first field specified. 


OUTPUT: any message or information typed by the system (as opposed to the 
user) at the terminal. This term is also used to refer to information to 
be punched onto cards, printed on the printer, or written out on magnetic 
tape. 


OVERRIDE: a flag set internally to indicate whether or not the user has re- 
quested the recording of trace information. 


PAGING AREA: a secondary storage area on disk which is assigned to a 
particular virtual machine and is used by the Control Program for tempurary 
storage of portions of core belonging to that virtual machine, in order 
to allocate main stérage dynamically among the various users. 


» ¥ 
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PARAMETER LIST: a string of double words used whenever a CMS command 
or function is called by an SVC instruction. The format of the parameter 
list varies depending on the command or function being called, but will 
always contain the name and operands of that command or function. 


PERMANENT DISK: a disk area allocated to each user (at the time he is 
authorized to use the CP/CMS system) on which stored files will be 
retained until the user requests that they be deleted. - 


READY MESSAGE: the message "R; T=xx.xx" which is typed as a response 
indicating the successful complction of a CMS command and a return to 
the CMS command environment. xx.xx in the above message is the CPU 
time in seconds used since the last Ready or error message. 


e 
REQUEST: input acceptable only to an environment which is unique toa * 
specific CMS command, 0a ig es 


RESPONSE: any non-error message typed out by the system at the’ terminal’ 


SPOOLING AREA: any disk arca used by the Control Program to temporarily 
hold input from the offline card reader or output to the offline card punch 
or printer, — 


SYSTEM DISK: a disk areca containing (1) the CMS nucleus, of which each user 
receives his own copy, and (2) the disk-resident portion of CMS, which is 
shared by all users. Pm Ee aoe nee 


SYSTEM FILE: any file residing on the system disk as opposed to the user's 
permanent or (eimporary disks. 
“TEMPORARY DISK: a disk area allocated to the user at the time he logs into 
the Control Prograrn, on which stored files will be retained only, for the 
duration of the terminal session. ee . 


TERMINAL SESSION: the period between a user's completed login to CP until 
he logs out from CP. (Note that new copies of the CMS nucleus may be 
obtained. during a terminal session). ; 


TEXT LIBRARY: a user or systcin file, whose filetype is TXTLIB, which is 
composed of (1) TEXT files containing relocatable object code and (2) a 
dictionary indicating the location and size of each of these TEXT files 
within the library. . 


TRACE INFORMATION: data (such as the contents of various registers and 
parameter lists) recorded by the system to enable the user to: trace 
transfers to and from SVC-called programs. : BY oak 9 





om 
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UNIT RECORD DEVICE* a card reader, card punch, or printer. 


USER FILE: a file residing on the user's permanent or temporary disk as 
opposed to the system disk, 


USERID; any combination of from | to 8 characters which uniquely identifies 
a user to the Control Program, 


VIRTUAL MACHINE: a functional simulation of a computer and its associated 
devices. Thc Control Program, by creating several virtual machines and 
allocating the hardware facilities of a single computcr among them, creates 
an atmosphere in which the users of the virtual machines may each function 
independently and with different operating systems. 
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DUMPREST dumps the contents of an entire disk area to magnetic 
Summary of Commands, Requests, and Console Functions tape or restores the contents of an entire disk area 
Se ee Nee a Oe ; Pee er eae as from magnetic tape, 
CMS Commands ECHO tests terminal line transmission by repeating as typeout 
cee ett ; whatever is typed in by the user. 
The CMS commands are briefly described in alphabetical order below. 
. z * . CMS ; A 
Each of these commands constitutes the only valid input to the Ch EDIT s Wawa Whe-weeh tarerente cn aeinepe fides Sndidiand 
command Spy Onne Dt. to make changes to existing files from his terminal, 
ALTER changes all or part of tle identifier (filename, filetype, : 
and filemode) of a file stored on the user's permanent ERASE deletes the entry for a specified file (or files) from the 
or termporary disk without altering the contents of the appropriate directory, rendering the file inaccessable 
file. to the user, and freeing the disk area containing that file, 
ASSEMBLE converts assembler language source code into relocatable : . 
object code using the OS/360 F level assembler. EXEC executes a file containing one or more CMS commands, 
allowing a sequence of commands to be exccuted by 
issuing a single command, 
CLOSIO signals the Control Program that I/O to offline unit record 
equipment has been completed and that the spooling areas ' ; : vay : 5 
for this 1/O may be processed. CLOSIO is generally issued FINIS closes the specified file (or files) by writing the Jast record of 
automatically by the commands which access unit record that file on disk, updating the user's file directory, and 
equipment. removing the entry for that file from the user's table of 
active files. ioe 
CLROVER clears overrides set by the SETERR and/or SETOVER 
commands and causes all recorded trace information to FORMAT . prepares the user's permanent or temporary disk area for 
be printed on the offline printer. CMS use by writing blank records over the currently stored 
information. 
COMBINE copies the specified file(s), concatenating them in the . ; 
order given, into a new file which is placed on the user's .FORTRAN converts Fortran language source code into relocatable 
permanent or temporary disk and assigned the specified : object code using the ©$/360 Fortran G compiler. 
identifier. P 
GENMOD creates a non-relocatable core-image file on the user's 
DEBUG allows the user to stop and restart programs at specified permanent disk which is a copy of the contents of core 
points and to inspect and change the contents of registers, between two given locations. 
core locations, and hardware control words online. 
GLOBAL specifies (1) macro definition libraries to be searched 
DEFINE creates an entry for a specified file in the user's copy of during the assembly process or (2) text libraries to be scarched 
the system file directory, enabling that file to be referenced when loading files containing relocatable object code. 5 
as a CMS command. } 
DISK causes a CMS disk file to be punched out or read in from cards 
which are in CMS card format. IPL, ’ performs an initial program load scquence on the version . 


of the CMS nucleus which has been saved by CP. 


KE 


KO 


KT 


KX 


LISTF 


LOAD 


LOADMOD 


LOGIN 


LOGOUT 


MACLIB 
MAPPRT 


OFFLINE 


PLI 


PRINTF 
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truncates information currently being typed at the terminal to 
72 characters per line, This truncation will remain in effect 


for the duration of the currently executing command or user 
program, 


clears overrides previously set by the SETOVER or SETERR 
commands and causes all trace infurmation recorded by these 
commands to be printed on the offline pripter: 


Stops typcout at the terminal for the duration of the currently 
executing command or user program, 


terminates the currently executing program; updates the user's 
permanent file directory; and logs out from CMS, transferring 
control to the CP environment, 


either types out at the terminal the identifier and size 

of the specified disk file(s), or creates a file on the user's 
permanent disk containing information for use by the EXEC 
and/or $ commands, 


reads the specified TEXT file(s) -- containing relocatable 
object code -- from disk, loads them into core, and estab- 
lishes the proper linkages. 


reads a MODULE file -- which is in non-relocatable core - 
image form -- from disk and loads it into core. 


causes the user's permanent disk files to be either saved or 
deleted, as specified. If LOGIN is not issued, the files will 
be saved. 


compacts the user’s permanent file directory; executes any CMS 
command specified as an operand; and logs out of CMS, trans- 
ferring control to the CP environment, 


generates or adds to a specificd macro library, 
or types out the contents of the dictionary of that library, 


creates, and optionally prints, a file containing a map 
of entry points in the CMS nucleus. 


' ereates a disk file from card input, prints a disk file on 


the offline printer, or punches a disk file on cards. 


compiles program written in PL/I source language 


into relocatable object code using the OS/360 PL/I (F) 
compiler, 


types at the termina! the contents of all or part of a 
specified disk file. 


. 


pl 
Ka 
~—S 


REUSE 


SCRIPT 


SETERR 


SETOVER 


SNOBOL 


SPLIT 


START 

STAT 

TAPE 
TAPRINT 


TXTLB 
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reads the specified TEXT file(s) -- containing relocatable 
object code -- from disk and loads them into core, es - 
tablishing linkages with previously loaded files and changing 
the default cntry point of these files to that of the first file 
specified in the REUSE command, 


either (1) allows the user to create arbitrary alphanumeric 
text files on disk and to make changes to existing files of 
this type from the terminal or (2) types out the contents of 
the specificd file, formatting it as indicated by control 
words contained in the text. 


scts error overrides which will cause trace information 
to be recorded for each SVC-called progsram which returns 
with an error code in general purpose register 15, 


sets normal and error overrides which will cause trace 
information to be recorded for all SVC-called programs -- both 
those which are executed normally and those which return 

an error code in gencral purpose register 15. 


converts a card-image file in Snobol source language into 
SPL interpreter language, and executes SPL1 programs. 


copies the specified portion of a card-image file and appends 
it to a second specified card-image file. 


begins execution of the loaded program(s) at the specified 
or default entry point and passes the address of a string 
of user arguments to the program(s). 


types statistics regarding the amount of permancnt and/or temporary 
disk space used; lists all user-dcfined commands; or compacts 
the user's permanent file directory, as specified. 


writes the contents of CMS disk files of any type or’size onto 
magnetic tape, er restores these fjles by writing them from 


tape onto disk, 


prints tape files created by the ASSEMBLE or WRTTAP 
commands on the offline printer. 


either (1) gencrates or adds to a specified text library» 

(2) types out the contents of the dictionary for that library, 
or (3) creates a file containing a list of entry points and 
control section names contained in that library. 


Nel 


UNDEF INE 


UPDATE 
USE 


WRTTAP 
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SG 


clears the specified entry (created by a previous DEFINE 
command) from the user's copy of the system file directory. 


updates the specified disk file with a file containing control cards, 
where each contol card indicates whether the information immediately 
following it is to be resequenced, inserted, replaced, or deleted, 


reads the specificd TEXT file(s) -- containing relocatable 
object code -- from disk and loads them into core, establishing 
linkages with previously loaded files, 


copies fixed-length files from any disk to tape. 
executes a file containing one or more CMS commands, or loads 


into core a file which is in either core image forin 
or relocatable object code and begins execution of that file, 


SY 


DEBUG Regue sts 
BREAK’ 


CAW 
CSW 


DEF 


DUMP 


GO 
GPR 
IPL 


KX 


ORIGIN 


PSW 
RESTART 
RETURN 


SET 


STORE 


x 
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specifies the core location at which a program 
currently loaded into core is to be stopped during 
its execution. a 


types out the contents of the channel address word 
as it existed when DEBUG was entered. 


types out the contents of the channel status word 
as it existed when DEBUG was entered. 


enters the specified symbol in the DEBUG symbol 
table, allowing it to be used thereafter in other 
DEBUG requests to refer to a specific core location. 


prints out the contents of the specified portion of 


. core either at the terminal or on the offline printer. 


begins execution at either a specified location or 
at the point where execution was interrupted when 
the Debug environment was entered. 


types out the contents of the specified general purpose 
register(s) as they existed at the time DEBUG was 
entered. 


performs an initial program load sequence on the version 
of the CMS nucleus which has been saved by CP 


terminates the currently executing program; updates 
the user's permanent file directory; and logs out from 


_CMS, transferring control to the CP environment, 


establishes a “base” address which will be added to all 
hexadecimal locations specified in other DEBUG requests. 


types out the contents of the old program status word 
which was saved at the time DEBUG was entered. 


re-initializes the CMS system, leaving the user in 
the CMS Command environment. 


returns the user from the Debug environment to the 
CMS Command environment. 


changes the contents of the specified general purpose 
register, word, channel address word, or program 
status word by replacing it with specified information, 


changes the contents of the specified core location 
by replacing it with specified information. 


types at the terminal the contents ofa specified or 
assumed number of bytes of core starting at the specified 
location, 


a 
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EDIT Requests 


The EDIT requests are described below in alphabetical order. These 
requests constitute the only valid input to the Edit environment, although 
some of the requests affect the format of input to the Input environment, 


BACKSPACE defines a logical backspace character for use 
in both the Edit and Input environments, The default 


character is %. 


BACKUP repositions the pointer the specified number of lines above 
the current line. 


BLANK places blanks in the indicated columns of the 
line at which the internal pointer is currently 
positioned. , 


BOTTOM positions the pointer after the last line of the file. 


BRIEF causes the bricf mode of the Edit environment 


to be entered, in which lines found or altered by EDIT 
requests are not automatically typed out. 


CHANGE rephices a specified string of information currently 
in the file with another specified string of infor - 
mation, 


DELETE delctes the specified number of lines from the 
m file, starting with the line at which the pointer 
is currently positioned. 


FILE writes the edited file on the user's permanent 
disk and transfers from the Edit environment to 


the CMS Command environment. 


FIND scans cach line of the file , starting at the line im- 
mediately following tne one at which the pointer 
is currently positioned, for a column-dependent 
match ‘with the specified information. 


INPUT ' transfers the user from the Edit environment to the 
Input environment. 


INSERT inserts the specified line of information into the file 
immediately after the line at which the pointer is 
currently positioned, 


LOCATE scans the contents of the file, starting at the line 
: immediately following the one at which the pointer 
is currently positioned, for the specified string of 
information. ° .¢ 


NEXT 


OVERLAY 


PRINT 


QUIT 


REPEAT 


RETYPE 


SAVE 


SERIAL 


TABDEF 


TABSET 


TOP 


UP 


VERIFY 


_moves the pointer féxward in the file for the number 
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of lines specified. 


replaces characters | in the line at which the pointer 
is currently positioned with the non-blankcharacters 


- specified. 


types out the contents of a specificd number of lines, 
startiug with the line at which the pointer is currently 
positioned, 


transfers from the Fidit environment to the CMS 
Command environment withgut saving the edited 
file. 


repeats the following BLANK or OVERLAY request the 
specified number of times. 


replaces the contents of the line at which the pointer 
is currently positioned with the line of specified 


information, 


writes the edited file on the uscr's permanent or temporary 
disk and returns to the Input cnvironment. 


establishes whether identification information is to 
be placed in each line of the file and,if so, specifies 


that identification information. 


defines a character which is to be recogniacd as 
the logical tab character in the Edit and Input 
environments. The default character is ff. 


establishes the internal or logical tab settings which 
are to be used in both the Edit and Input environments. 


positions the pointer to a null line which precedes the first 
line of information at the beginning of the file. 


see BACKUP. 


causes the verify mode of the Edit environment to be a 
entered, in which the contents of lines found or altered by 


EDIT requests are automatically typed out. 


tu 
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SEEK scans each line of the file, starting at the one at 
which the pointer is currently positioned, for a 
SCRIPT EDIT Requests , : column-dependent match with the specified information, 


The SCRIPT EDIT requests are described below in alphabetical order, 7 . 
The requests constitute the only valid input to the Script Edit environment. TOP _ positions the pointer to a null line which precedes 
2 a the first line of information at the beginning of the file. 


BOTTOM prints the last line of the {ile being edited, positions the 


pointer bclow this line, and enters the Script Input environ- SCRIPT PRINT Control] Words 
ment, Se ee 
CHANGE replaces the specified string of information in the current 
‘ Jine with another specified string of information, ‘ 
Page Format; 
DELETE deletes the specified number of lines from the file, = 
starting with the line at which the pointeris currently _ +PLin specifies the number of lines to be typed on a page (The 
positioned, default value is 66), 
FILE | writes the edited file on the user's permanent disk, and -BMn specifies the number of lines to be allowed for the bottom 


transfers from the Script Edit environment to the CMS margin of each page (The default value is 3). 


Command environment. 


: ~TMn specifies the number of lines, including the header line, to 
INPUT transfers the user from the Script Edit environment Re allowed ter the: fepenarg ion eech pape: (ihe default value 
to the Script Input environment. is 5). 
INSERT. causes a single linc of input to be added to the file without ’ 
transferring to the Script Input environment. Spacing: ; =? 
KEEP creates a file on disk which consists of all material (4) from -DSn double spaces the information being typed out, 
, the beginning of the current SCRIPT file or (2) from the point 
at which the last KEHNP was issued, — -55n - single spaces the information being typed out. 
LOCATE searches the SCRIPT file for the first occurrence of the -SPn inserts the specified number of carriage returns prior 
specified string. ae? , to typing the next line. 
NEXT moves the pointer forward in the file for the number . 
of lines specified. Parent sph Permet 
PRINT types out the contents of a specified number of lines, * Lin specifics the line length in characters (The default value is 60), 
Starting with the line at which the pointer is currently 
positioned, -INn allows the left side of the printout te be indented, 
QUIT transfers from the Script Edit environment to the ‘ - OF n allows printout to be offset by indentinf all but the first 
CMS Command environment without saving the edited ~ Poot mee clion: 
file. : 
REPLACE replaces the contents of the line at which the pointer 


is currently positioned with the line of specified in- 
formation, 


( 
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WORDS Sib 
Page Control: 


»PAn starts the next Jine on a new page, 


- PN controls both external and internal page numbering of the 
file being printed. 


. HE heading 
causes the next line to be used as a header line, and to be 
typed at the top of each page. 


Format Mode: 
e 
» BR causes a break, meaning that information appearing before 
and after the . BR request will be typed on separate lines. 


-FI "fills" the lines being typed out by (1) lengthening short lines: 
by moving words from the following line (2) shortening long 
lines by moving words to the following line and (3) adjusting ° 
; lines to the right margin by inserting additional blanks between 
words. in the linc, 


»NF types all lines exactly as they appear in the file, truncating 
lines longer than the currently-set line length (. FI is assured 
if neither .NR nor . FJ is specified). 


CE centers the next line between the left and right margins. 


Special Features: 


-RDn issues the specified number of reads at the terminal to allow 
user input to be inserted in the printer, 


-CPn causes a page eject to occur if less than the specified number 
of lincs remain on the current page. 


Manuscript Layout: 


»-AP name 


appends the contents of the specified SCRIPT file to the file 
just printed, 


IM name 


inserts the contents of the specified file into the printout of : 
another SCRIPT file. 
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control Program Console Functions 


The Control Program console functions arc described below in 
alphabetical order. ‘These console functions constitute the only valid 
input to the Control Program environment 


BEGIN begins cxecution at the specified address or, if 
no address is given, at the location at which 
execution was interrupted. 


CLOSE _releases the spooling areas containing input 
from the card readcr or output to the printer 
or card punch. 


DETACH removes the specified device from the user's 
virtual machine configuration. 


DISPLAY types at the terminal the contents of the specified 
register(s), core location(s), or program status 
, word. 
DUMP prints the contents of the specified register(s), 


core location(s), or program status word on the 
offline printer. 


EXTERNAL simulates an external intcrrupt to the virtual machine. 
An EXTERNAL console function followed by a BEGIN will 
cause the Debug environment to be entered. 


IPL Simulates the Initial Program Load sequence on the 
specified unit. 


LOGOUT releascs the user's virtual machine, including his 
* temporary disk area, and closes any spooling areas 
which have not been released. 


MSG types out the specified message at,the terminal of 
the person whose userid is specificd. 


QUERY types out either the number of users logged onto the 
system, the names of these users, ot the maximum 
pumber of users allowed to log om or the log message 
set by the operator. 





re 


honed 


READY 


RESET 


SE'T 


STORE 


TIMER 
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STE 


simulates a device end for the specificd unit, 


simulates the system reset key on the 360 console 
by resetting any pending I/O interrupts. 


controls the messages typed at the terminal, 
replaces the contents of tha specified register(s), 


core location(s), or progra.n status word with the 
specified information, 


controls whether real time or CPU time is 
kept for the virtual machine, 


CARDPH 


CARDRD 


CONW AIT 


DESBUF 


ERASE 


FINIS 
POINT 
PRINTR 
RDBUF 


SCAN 


STATE 
STDERR 
TAPEIO 
TYPE 


TY PLIN 
WAIT 


WAITRD 


WRRUF 
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CMS Functions 


Punches a card from the specified area, 
Reads one card into the specified area. 


Waits for console I/O to."'finish" all stacked reads 
and writes. 


Releases buffers used by console routines, 


' Performs the function similar to theERASE Command, 


Closes one or more specified files, 

Sets a pointer for subsequent file references. 

Prints one line on the printer or issues a carriage restore, © 
Reads information from disk.. 


Scans a line of input and places strings of non-blanks 
into a comrnand buffer, : 


Provides information about disk files, 


Obtains information about the last error, 


" Reads/Writes and performs various tape 1/0 functions. 


Types one line on the console with a carriage return, 


Types one line on the console and gives one carriage 
return. | 


Wait state is entered to await an interruption from one 
of the devices specified as arguments. 


Waits until one line is read from the console, 


Writes information onto disk, . 


L006 
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APPENDIX B APPENDIX B 
Format of Commands, Requests, and Console Functions Format of Commands, Requests, and Console Functions 
Below is a key to the symbols used to represent conimand formats in this 
Contents | Page appendix: 
Key to Format Symbols "4 UPPERCASE - information given in capitals must be typed 
CMS Commands ? eeacthy as BUON DE although it may be entered 
: in either upper or lower case 
DEBUG Requests ies a) ; 
@ lowercase - lower case information designates the con- 
EDIT Requests 10 tents of a ficld, and docs not in itself con- 
SCRIPT EDIT Requests ‘ 12, stilute mcaningful input. (AN lowercase 
symbols are defined on page 3.) 


SCRIPT PRINT Control Words 13 


- 
mn 
» 
o~ 
ww 
t 


parentheses must be typed as shown when 
any of the information appearing within 
them is specified 


Control Program Console Functions 


Option Meanings and Defaults 17 


. a period designates the beginning of a 
Script Print control word, and must be 
typed as shown 


- - + a hyphen must be typed where shown, and must 
. not be offset by blanks 


. j -  aslash denotes any string delimiter, other than 
; blank, which does not appear in the string 


* - an asterisk, specified where shown, indicates 
the universality of an item or items 


The following are logical symbols only, and should not be typed: 


[ J - brackets indicate information which may be 
omitted 
[ 1 J - successive brackets cnclose items which, if 


specified, may appear in any order 


i 


[t 1] nested brackets indicate items which, if 
: specified, must appear in the order shown 








Lor 


Zone 


-not enclosed in braces, the underlined item 
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Vo 


braces enclose stacked items, only one of 

which may be specificd. With stacked items 
x order below: 
may not be specified. 


anycom 
arg 


c 
defent 
defset 
devadd 


an ellipsis indicated that the preceding item(s) 
may be rcpeated more than once in succession 


editfin 
entry ~ 
eof 
first 
fm 

fn 

ft 


these suffixes indicate first, sccond, third, 
and Nth items respectively 


this symbol indicates a continued line hesduto 


hexloc 
id 
intloc 


lining indicates t » Which will be 
underlining indicates the value which w aca 


assumed if none is specified, When no under- 
lined item appears in bracketed [ ] information, 
the default value is none. Underlined items 
-not enclosed within braces { } may not be 
specified by the user, 


length 

‘ libname 
line 
n 


norec 
newfm 
newfn 
newlt 

~ nextloc 
oldfm 
oldfn 
oldft 
option 
reg 
eq 
setmar 
string 
symbol 


syslib 
typcout 
. userid 





nolineno. - 
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All lowercase symbols used in this appendix are described in alphabetical 


any CMS command 
any user argument to be passed to a program 


any text character appearing on the 2741 keyboard 
default entry point 

default option settings 

device address 


filename specified in EDIT command 

an entry point or control section name 

end of file 

first occurrence of the specified item found 
filemode 

filename 

filetype 

a full word or less of hexadecimal] information 
hexadecimal core location : 

an alphanumeric identifier 

core location at which processing was interrupted 
core location specified in last DUMP request In the 
Debug environment 

inherent length attribute 

the filename of a library 

a group of position-dependent 2741 characters 

a decimal number 

line number not typed 

no formatting of first three disk records 

new filemode 

new filename 

new filetype 

next available load location 

old filemode 

old filename 

old filetype 

an option of the indicated command (see pages 14 and 15) - 
the number of a register (in decimal) 

sequential page numbering 

original margin or tab settings 

any group of 274] characters 

a name for which a DEF request has been 

issued in the Debug environment 

system text library, unless otherwise specified by an option 
type out information at the terminal or previous command 
identifier by which user logs in to CP 


bot 


CMS Commands : 


{ALTER} 


« AL } 


ASSE ae 
CLO 


ee 
{°" ot 
oe: 


Ch pat es 


fess 


pace 
DEB 


(on) 
(” “sy 
or) 


DIS 


D 


og 

EC 

aes 
E 


ae rus 


ae ay 


oldfn oldft {ores} {neta} frewe} {: 
* x * 
. fnN | (exio 1... option) ] 


[eave | [Paver [Ponce 


fn 


1. 


ewfim 
* 


newfn newit hewitt oldfnl oldft1 oldfm1l 2 


fn 


{ 


-e OldfnN oldftN oldfmN 


DUMP fn ft fm 
.LOAD 


lax n 


[=] 
ts} 


{* 
* 


is} 
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3.4.4-4 


3.4.4-4 


3.4.2-4 


3. 3. 4-4 


3.4. 3-4 


3.3. 2-4 


3. 5. 4-4 


3.4.4+4 


3.4.5-4 


3.5.2-4 


3. 1.6-4 


3.4.7-4 


ered 


c a) 
a EXEC 


EX § 


\ Finis t°. 


eae 


FORMAT 
FORM 


FORTRAN ' 


F 


\ GENMOD ¢ 
age ak 
\ 4 


“GLOBAL ° 
1 GL ‘ 


é 


Lip} 


| IP. 


KE 
KO 
KT 


KX 


fee 6 8 


. 1 
- LOAD ¢. 
* LO 


fn [arg ves argN | 
{9} {i} {fh 
* * \ * 
first, 
an ie 707) a 
a { Norec 4 


fnl ... InN 


[orion Tiss 


entry 1 





entry 2 
nextloc 


ASSEMBLER MACLIB 
LOADER TXTLIB 


} [ tibname 5 


Ares Iibuamen | 


{i} {i} {fre (EXEC) 
. z P and 'T (t) 
ane, typcout 


fnl_... fn (option Io cee 


optionN) > 


as 


‘Tbname 1 ee 
syslib 


opti ons)| 
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CMS COMMANDS 


Page Ref, 


3.5. 3-1 


3.1. 8-1 


3.5.4-1 


3.4. 2-1 


3,2.1-1 


3,4,2-1 


3.5, 14-1 


3.5. 5-1 


3.5. 6-1 


3.5. 7-1 


3.5, 8-1 


3.1.9-1 


3.2,3-1 





(te 


\LOADMOD ¢ 


’ LOADM \ 


LOGIN | 
* LOGI ) 


. LoGouT 
LOG } 


y 


\ 


Ma 


"MACLIB? 
sy M A 


\. 


f “MAPPRT } 


, MAP 5 


, OFFLINE - 
: ce) } 


~~ 


PI, iy 
uy 


2 
|; PRINTF ., 
Po} 


“REUSE | 
aes eae 


' 
) sc RIPT $ 
» SG 
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CMS COMMANDS 


: . Page. 
fn “ 3.2. 4-7 
UFD | . a aa 
NO_UFD : ; 3.5.9-1 
cr “| * 4 
{anycom} 3.5,10-1 
GEN libname fnl ... fnN 
ADD libname fnl ... fnN 3.1.10-1 


LIST libname 


k 


t 
BN 


PUNCH .~ 
PRINT im ott [im] 
PRINT CC first 
PRINTPLI ; 
READ ie. Selina 3.1. 11-1 
Pl 
* 
fnl ... fnN [option see Option N)] 3,4, 3+] 
rf 1 n2 n3 
fn ft ro 
{3} { | son 3.3,12-1 
fnl , “a {nN [option . . . optionN) aSae.4 
‘libname 1, lbramen)| v 
EDIT — fn Ba 
: r > »1,13-1 
SPRINT fn | (option 1... option N), A 
} 





(3 ea 3.5. 13-1 


w/ 


Gy 





fnN 


fiN 


) SETERR} 
SETE 
( SETOVER SAMELAST foption! ... optionN] 
( SE defset 
SNOBO 
SN fn =| (option 2... option N )] 
“f SPLIT idl pe 7 
ee fnl ftl fn2 [2 ie | te 
| 
STAR dee ; 
} gant} | sae [args «os argNn 
P 
T 
Vera i : 
Vs j e 
7 2, T, and D 
LOAD 
. REWIND 
TAPE) SKIP 3 
ae: J WRITEOF 
: S 
DUMP fn ft|<T 
P 
TAPRINT ° TAP 
{ TAPR } TAP2 
(a jibaame’ as 
ADD ; 
es TXTLIB { A } libname fnl slats 
> _ bd 
eal \ libname 


LIST vee 
I i libname 
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CMS COMMANDS 


Gor 
Page Ref. 
ie oS 


3.3.4-1 


3.4.4-1 


3.1, 14-1 


3,2,6-1 


3.5, 11-1 - 


3.1,15-1 


3.1. 18-1 


3.1016-2 


‘ 7-19-68 


d ; APPENDIX B-9 
bes — 7H19-68 : DEBUG REQUESTS 
APPENDIX B-8 DEBUG Requests bO9 Page Ref. 
CMS COMMANDS : Tee ee pe ee eye 
: : * . a symbol . 
. Page Ret, LO& BREAK Reiiec! 3.3.2-4 
. UNDEFINBt {=} - 3.5.12-1 
° - y CAW 3.3,2-10 
csw 3.3.2-11 
: ) ftl fn2 
VUPDATE. fna n ft 2 n 
,oui 3 sysinf |\fnif |fuppare {| | | 32272 DEF symbol _ hexloc if Cae Ree 
, , . symbol 2 
: symbol 1 
ies : ONLINE ; hexloc 2 : 
USE , ful... fnN [loption 1. . .optionN) 3,2.7-1 DUMP {' id } {ese 1 * 3.3,2-15 
| us he libnamel... libnameN]] 2 0 3 
f WRTAP” . , | symbol } 
{ Wwe } fee : | ae ay fe 3.3. 2-21 
, intloc 
° fn [ere tee argN | 3.2. 8-1 GPR regl [reg2] 3.3,2-24 
IPL 3,3, 2-26 
KX ; "  3,3,2-27 
: symbol 
ORIGIN ote } : 3.3. 2-28 
PSW : | 3. 3.2-30 
RESTART : , 3. 3.3-32 
RETURN . 3.3.2-33 
CAW hexinfo 
1) 
ees CSW hexinfo [hexinfo] 3.3, 2-34 
PSW . hexinfo — [hexinfo] 
GPR reg hexinfo  [hexinfo] 
; s' 3 symbol {| er : : 
roRt { hoise hexinfo | hexinfo [ hexinto] 3.3. 2-38 


vo symbol 


n 
length 


a 


AED 


Pl 
co 


3.3, 2-42 
hexloc 





NEX’P). 
N 





eh] 
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: : 7-19-68 APPENDIX B-11 
bie ROLE DG RA. . | | GH EDIT REQUESTS 
. EDIT REQUESTS eee or 
We . é : —Aee 
; 6/ >) - fOVERLAY - 3.1. 6-28 
EDIT Requests a Page Ref. se O ne 
[ees C 3.1.6-9 | 
BACK % eae n\ | fLINENO 3.1. 6-30 
‘ e - ; P i L 
: nolineno 
f BACKUP , - ae 3.1. 6-10 a a | 
i ae 7 four iG on 
U ; =-4! : : Q ; - 
BLANK 7 3.1,6-11 — : eo . 
B Uns REPEAT +4 i 3,1. 6-32 
: | a 2 U2 
BOTTOM 3.1,.6-12 “PRET z 
{ ~ BO a} line 3, 1, 6-33 
BRIEFY 3.196443 | 
BR f, : SAVE 2 ] 3.1. 6234 
nee Me : : edit fn} 
‘ * . . 
CHANGE ). -. ’ a: n G 3.1. 6-14 
SER (NOs | (10 
“ DELETE | VF . 3.1,6-16 : 
D fosing ji ee 3.1. 6-38 
: Tae f ; {5 
FILE fs 3.1, 6-18 
editfn ‘TABSE s 3.1. 6-39 
ine} ia ve. nN 
; setmar 
ee, ee 3. 1. 6-20 
Cat 3.1. 6-42 
eae 3.1. 6-22 
I 
{ UP } - 3.1, 6-42 
: i} 
eae line 3.1. 6-23 . BACKUP i ci 
ue VERIFY - 3.1, 6-43 
3.1. 6-25 ‘als 
age oe /string/ i) { VER t [fx 2}] 
L sy cae: 
3.1. 6-27. 


Liv 


SCRIPT EDIT Requests 


arma 
B 


Eg ouaNGE | . /{[string1) /{ string2] / 
DELETE (n 
D 1 
{ FILE * [ nin | 
F J - (om, 
INPUT 
1 = 
{INSERT |  * line 
tog J 
KEEP| 
{ K } = 
qocME / string / 
. 


ee) 


string 
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SCRIPT EDIT REQUESTS 


Page net, O6L > 


3.1. 13-8 


3.1.13-9 


3.1.13-11 


3:1,13-12 
3.1.13-13 


3,1.13-14 


3.1.13-15 


- 3.1.13-16 


3.1.13-17 


3. 1.13-18 


3.1.13-19 


3.1.13-20 


3.1.13-22 


3,1,.13-23 


SCRIPT PRINT Control Words 





.AP fn 
. BM n 
i 
.-BR 
.CE 
cP n 
.DS 
FI 
» HE . line 
. IM fn 
IN n 
setmar 
. LL n 
. NF 
. OF n 
setmar 
.PA ni: 
seq_ 
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APPENDIX B-13 
SCRIPT PRINT CONTROL 


WORDS b /> 


Page Ref, 


3.1.13.24 
3.1.13-25 
3.1, 13-26 
3.1.13-27 
3.1, 13-28 
3.1.13-29 
3. 1,13-30 
3.1. 13-31 
3.1. 13.32 
3.1.13-33 
3,1.13-34 
3,1.13-35 
3.1, 13-36 


3.1. 13-37 





1 


.PL 


. PN 


»RD 


.SP 


. TM 


7=19=68 
APPENDIX B-14. G/F 


SCRIPT PRINT CONTROL | 


WORDS 


3, 1.13.38 


3,1. 13-39 


3,1, 13-40 
3,1, 13-41 
3,1. 13-42 


3,1, 13-43 


~"") " Control Program Console Functions 


BEGIN hexloc 
i B - intloc 


et devadd 
CT 
we devadd 


ae 
eee . fhexloc] [nextoc1-hexloc3] [Lhextoc] 


[Lhextoct-hexloc3] [Greg] [ Gregi-reg2] 


[yreg] [Yregi-reg2} (rsw) 


{Pout [hexloc] [hextoc 1-hexloc 2| [Lhextoc] 


[Lhextoci-hexloc3] [Greg] [Gregi-reg 3] . 


[yreg] [Yregi-reg?] [Psw] 


EXTERNAL 

E 
fri es 
li! devaddi 


LOGOUT 
JL 


7-19-68 is 
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CP CONSOLE FUNCTIONS 


Page Ref. 


4,1, 1-1 


4, 1, 2-1 
4.1,3-1 


4, 1, 4-1. 


4,1,5-1 | 


4.1,6-1 


4.1.7-1 


4.1,8-1 


(16 


: "MSG userid li 
M ALL —r 


USER [NAMES] 


eras } LOGMSG 
. = Q 
READY —_devadd 
RESET 
R 
: ; MSGOFF 
See MSGON 
ee 2 _ [Lhextoc hexinfol aoe hexitifoN 


3 [Greg hexinfol ... hexinfoN] 
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APPENDIX B-16 
CP CONSOLE FUNCTIONS 


4.1.9-1 


4.1,10-1 


4.1,11-1 


4.1,12-1 


4.1. 14-1 


4.1,.13-1 


CMS Command Options. 


ASSEMBLE 


ae ttt 


3.4.4 


FORTRAN 
3.4.2 


Defaults: 


DECK 
DIAG 
LIST 
NORENT 
XREF 


LDISK 


DECK 
DIAG 
EBCDIC 
NOGO 
NOLIST 


NOMAP 
NOPRINT 


SOURCE 


q- 19-68 b 
APPENDIX B-17. 6/7 
CMS COMMAND OPTIONS: 


Meaning of Option : Option. 
do notcreate a TEXT file NODECK ] 
do not type diagnostics at the terminal NODIAG 
do not create a LISTING file NOLIST 
check for re-entrant coding RENT 
do not create a cross-reference table NOXREI 


in LIS'TING file 

write the LISTING file on the permanent 
disk 

write the LISTING file on the tape whose LTAPn 
symbolic address in TAPn 


write the LISTING file on the offline LPRINT or PRINT 


printer 
do not create a TEXT file NODIECK 
do not type diagnostics at the terminal NODIAG 
Source program is in BCD code BCD 


force compiler processing to conipletion GO 
include assembler mnemonics in LISTING LIST 
file - ; 
include storage map in LISTING file MAP 
print LISTING file on the offline printer PRINT 
and crasc it from the permanent disk 
do not include source code in LISTING file NOSOURCE 


[Yreg hexinfol ... hexinfoN] 2 
| psw hexinfo1} hexinfo 2| Ps LOAD. 


3.2.3 "MAP do not create a LOAD MAF file NOMAP 
NOCLEAR clear load region to zeroes before loading CLEAR 
a ec ae 2 NOTYPE type Joad map contents at the terminal TYPE 
ON ; : NOXEQ execute the loaded file(s) XEQ 
a { ors f Aededen) PINV do not include invalid cards in the load map SINV 
\ CPU PREP do not include Replace cards in the load SREP 
map 
§LC12000 start loading program at hexadecimal lo- ~~ SLOxxxxx 
cation XxXxxx 
SYSLIB search only the specificd TXTLIB files LIBE 








Lig 


Defaults 


c60 
D. 


EB 
FW 
FW 


NA 
NL 


NLD: 
NM 
NX 


S 
S2 


ST 


suppress 
punching of 
TEXT file 


CMSPRINT 
P 


suppress 
writing of 
LISTING 
file on tape 
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Gk 


APPENDIX B-18 


Meaning of Option 


CMS COMMAND OPTIONS 


Option 

suppress compilation after compile- NC 
time processing has been completed 

48-character set available on offline C48 
printer 

suppress creation of TEXT file ND 


suppress External Symbol Dictionary NE 
in LISTING file 


source program is punched in BCD B 
suppress warnings in LISTING file FE 
suppress warnings and crrors in FS 


LIS'TING file-include only severe 
errors 

include Attribute Listing in LISTING A 
file 


include assembler mnemonics in ~L 
LISTING file om 

create a SYSLIN file ; LD 

compile-time processing is required M 

include a Cross Reference Listing Xx 
in LISTING file 

suppress listing of source program NS 

suppress listing of input to compile- NS2 
time processor 

suppress statement numbers in NST 
‘execution-time diagnostics 

punch TEXT file on offline punch Neer 

K 


suppress printing of LISTING file 
on offline printer 
write LISTING file on tape 180 


write LISTING file on tape 181 


he Pk) 


per 3 Pk2 


2 


J oMeHOENT 


aa , 


Defaults 


SCRIPT PRINT © 


3. 1,43 


SNOBOL 


3.4.4 


do not pause 

wait | 

do not translate 

Start at page 1 

type output at 
terminal 

start at print 
position 4 


write LISTING on 
permanent disk 


write LISTING on 

. permanent disk 

create LIS'TING file 

compile SNOBOL 
file. 


7-19-68 ‘ 
arpenpixp- 19 LF 
CMS COMMAND OPTIONS 
; ; 
Meaning of Option | Option 
pause at end of each page STOP 
start printing immediately NOWAIT 
translate lower case to upper case TRANSLATE 
start printout at page xxx PAGExxx 
print output on offline printer OF FLINE 
center output on offline printer CENTER 


print LISTING file on offline printer OFFLINE or 


PRINT 
type LISTING file at terminal ONLINE 
do not create a LISTING file NOLIST 


execute SPL4 file : SPL1 


L355 7-19-68 
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CMS COMMAND OPTIONS 


2-05-68 b2t/ 
APPENDIX C-I 


60 } APPENDIX C 
CP/CMS MESSAGES 
Defaults Meaning of Option. Option 4 ERR. PAGE 
MESSAGE SOURCE CODE REF. 
SETOVER A FILE HAS THE WRONG RECORD LENGTH. TXTLIB 3e1.16-3 
3.3.4 record general purpose register (GPR) GPRS A FILE 1S MESSING TXTLIB 3.1.16-3 
record no contents before branch and after return ; . . ie hee 
GPR information record GPR contents after return only GPRSA ACE DEFINED DEFINE 3 325- 
record GPR contents before branch only GPRSB AN INPUT FILE DOES NOT EXIST. MACLIB 05 301-10-4 
AT LEAST ONE OF THE FILES YO ASSEMBLE OCESN IT ASSEMBLE 01 3041-7 
EXIST GR DOESN*T HAVE A CORRECT TYPE NAHE. 
record floating point register (FPR) contents FPRS 
record no before branch and after return AT LEAST ONE OF THE FILES TO ASSEMBLE HAS ASSEMBLE ol 3041-7 
FPR information s-cord FPR contents aftcr return only FPRSA ENCORRECT RECORD LENGTH. 
record FPR contents before brz *pRS 
ca ae AT LEAST ONE OF THE FILES TO BE COMPILED FORTRAN Ol -3.4.2-7 
COESN'T EXIST CR DCESN®T HAVE A SFORTRAN! 
( TYPE NAME. 
di 2 Hines record no parameter Uet information NOPARM AT LEAST ONE OF THE FILES YO BE COMPILED HAS FORTRAN OL 324.2-7 
oO parameter list record 1 line of paranceter Jist PARM1 LOGICAL RECURD LENGTH DIFFERENT OF 80 BYTES 
ATTEMPT TO COMBINE FIXED AND VARIABLE LENGTH CONBINE 13 3.1.3-2 
FILES. ; 
: record no information for WAIT NOWAIT 
record basic record same information for WAIT as WAITSAME ATTEMPT TO PRINT RECORD GREATER THAN 132 OFFLINE 06 3.1611-6 
line for WAIT for other routines COLUMNS. 
record 1 line of parameter list for WAIT WAITI ; ; - 
record 2 lines of parameter list for WAIT WAIT2 ATTEMPT TO PUNCH RECORD GREATER THAN 80 COLUMNS OFFLINE 03 3.41.11-6 
ATTEVPT TU WRITE OUTPUT FILE GN SYSTEM DISK COMBINE 12 3-1.3-2 
ILLEGAL. : 
use current 3 : 
t vi ; EFAULT 
settings resct options to default values DEF, BAD ARCCHENT CP. ree ee | 
7 CP BEGIN 4&elel-l 
CP CLOSE 421.22-2 
CP DETACH 4.1.3-1 
CP DISPLAY 4o1.4-2 
CP DUMP 4e1.5-2 
° cP TPL 4&el 7-1 
CP MSG 4-e1.9-1 
CP QUERY 4e1.10-1 
CP READY 4.1.11-1 
CP STORE 421.13-2 
: x CP TIMER Gelel5-1 
BAC MDE SPLIT 3e1.14-2 
BAC CuTPuT TYPE SPLIT 3.1.14-2 








G22. 


8 €R TOU SMALL 
CALLER =XXXXXXXX 

‘ CALLER =XXXXXXXX . F : 
CE AND CE NOT FOUND TOGETHER (VERY STRANGE} 
CE AND CE NOT TOGETHER CHECKING NO. CYLINDERS 
CHS LOGGING OUT... . 

TOTAL CPUTIME (IN SECONDS) © XX.XX 

CP ENTERED, READY. | 

CMSeae VERSION 120 - 05/01/69 
COMMANO-TU~BE-UNDEFINED NOT FOUND IN SSTAT 


COMPILATION CANCELLED DUE TH SOURCE PROGRAM 
ERRGR(S). 


CONDITICN-CODE 1 ON SIO EN FORMATTING DISKIBAD) 
CONDITION-CCCE 2 ON SIO IN FORMATING DISK(BAD) 


{ DITICN-CODE 3 CN SIC IN FORMATING DISK{(BAD) 


SPLIT 
CLROVER 
CLROVER 
FORMAT 
FORMAT 


CMS LOGOUT 


CMS 
UNDEFINE 


FORTRAN 


FORMAT 
FORMAT 


FORMAT 


CORRECT FORM: ERASE FILENAME FILETYPE FILEMODE, ERASE 


NANE ANC/OR TYPE MAY BE *~, AND 
MOCE MAY BE * OR BLANK. 


CORRECT FORM IS 
DISK DUMP FILENAME FILETYPE FILEWMODE 
OR CISK LOAD. 


CORRECT FORM 1S: COMBINE N1 TL WML N2 T2 M2ene 
WHERE Ni,oTL»Mi ARE THE NAME, TYPE, 
THE FILE 10 BE CREATED. AND N2 T2 M2, 
ARE THE FILES TO BE COMBINED. 


ETC. 


CORRECT FORM IS: 
WHERE FILENAME, FILETYPE, AN 
FILENANE AND/OR FILETYPE MAY BE. 
PoTeSe%e OR OMITTELC. SEARCH IS (PeT) IF 
CHITTED, GR (P,TeSPIF *. 


CORRECT FORM IS :"QFFLINE* CONMAND FILENAME 

FILETYPE OPTICNAL-FILEMCOE WHERE COMMAND 1SQ 

*REAC', "PRINT', "PRENTCC*, OR * PUNCH’, 

TF FILENAME=* UNDER READ MC DE, CONTROL CARDS 
© EXPECTED IN INPUT STREAM, 


CORRECT FURM [S; *PRINTF* #ILENAME FILETYPE 
STARTLINE ENDLEINE LINE-LIMIT, WhERE 
*STARTLINE', *ENDLINE', AND "LENE-LIMIT*® ARE 
OPTICNAL 


AND MODE OF 


LISTF FILENAME FILETYPE MCDE 
AND MODE ARE OPTICNAL. 
MODE MAY BE 


DISK 


COMBINE 


LISTF 


OFFLINE * 


PRINTF 


2-05-68 Aus 
APPENDIX C-2/ 
Belel4—-2 
3-3-1-3 
3e301-3 
04 = - 3 en 2 
06 =. 3250-2 
345.102 


2620273 
02 3e5e212~2 


02 325 4~2 
O02 305 04~2 


(02 3650442 


01 ZeleT-2 
021 3el64~-3 


10 301.23-2 


O1 3.1.93 


Ol 301. 11-6 


Ol Belel2-2 


( . . 
“CORRECT FORM IS; "SCRIPT* COMMAND NAME 


WHERE COMMAND IS *EDIT*® OR *PRINT*. 


CORRECT FORM IS. SCRIPT EDIT FILENAME, 


CORRFCT FORM: MACLIB COMMAND MACLIB-FILE 
{ASP360 FILES) WHERE COMMAND IS GEN e LIST 
CR AOD . 


CORRECT FORMS ARE: : 

TAPE DUMP FILENAME FILETYPE FILEMODE 

TAPE LOAD TAPE REWIND TAPE WRITEOF TAPE SKIP 
CURRENT USERS AREse. 

DEBUG ENTEREDs.. 


CEBUG ENTERED, EXTERNAL INT. 


CEBUG ENTERED 
BREAKPOINT XX AT XXXXXX 


» CEBLE ENTERED 


PROGRAM INT. PSWEXXXXXXXXXXXXXKXK 


CEFALLT TABS SET. 


CEFINED COMMANO(S) = *COMMAND1« » eCOMMANON® 


DEFINED MORE THAN ONCE  XXXXXXXX 


CEV XXX DETACHED. 


CISK ERROR. 


DISK ERROR WHILE READING. 


jPISK ERROR WHILE WRITING. 


‘anal 


C&SK FULL 


DUMP~--XXXXXXXX 





SCRIPT 


SCRIPT 


MACLIB 


TAPE 


CP QUERY 
DEBUG 

DEBUG 

CP BEGIN 

CP EXTERNAL 


DEBUG 


DEBUG 
SCRIPT 
EDIT 
STAT 


LOAD 
REUSE 
USE 

$ 


CP DETACH 


GENMGD 
LOADMOD 
PRINTF 
SCRIPT 
SPLIT 

$ 


COMBINE 
SCRIPT 
TAPE 


COMBINE 
TAPE 


SPLIT 


DEBUG DUMP 


2-05-68 EL? 


APPENDIX C-3 


69° 341.2136 


Ol 341.13-5 


01 3.1.10-3 
01 Bel. 15-4 


4.1.10-1 


3e3e2-2 
301.13-5 


ol 3 
01 3 
ol 3 
03 3 


02-13 Be2e1-~2 
01-10 30224-1 
02 3e1212-2 
02 3el.13-5 


3el.14-2 
03 342.8-3 
02 3e1.3-2 
12 30e1-13~6 
02 3e1.15-4 


03 = 34 1.3-2 
O03 341.15-4 


3e1.14-2 


3.3. e-15 


b.d# 4 


LUMP/RESTORE MOVED NNN CYLINDERS. 
THERE WERE NNN RECOVERABLE TAPE ERRORS. 


ECXXKXX) T=XX.XX 
ECXKXXX) 


EDIT: 


END CARD MISSING FROM DISK LOAD DECK. 
END CF TAPE 

ENDING RECORD OF FILE MISSING. 

ENTER PASSWORD: . 


EOF REACHED. 


-OF REAC ON TARE 


EQF REACHED BY: XXXeweXXX 


ERRET=XXXXXXXX 
ERROR DURING IPL SI0- 
ERROR IN NAME» TYPE, OR MODE OF OUTPUT FILE 
ERROR ON DISK 
€ECOSERROR—OVERRIDE 
ERROR WHILE LOADING THE IEYFORT MODULE. 
ERROR WHILE PRINTING.» 
ERROR WHILE PUNCHING. 


ERROR WHILE REACING 


ERROR WHILE READING OISK. 


Ps 


6/ 2-05-68 


APPENDIX C-4 


* DUMPREST 


CHS 
EXEC 


EDIT 
SCRIPT 


DISK 06 


TAPRINT 
TAPE 06 
CP LOGIN 


SCRIPT DELETE 
SCRIPT LOCATE 
SCRIPT NEXT 
SCRIPT PRINT 
SCRIPT SEEK 
SPLIT 


TAPRINT 


EDIT BLANK 
EDIT CHANGE 
EDIT DELETE 
EDIT FIND 
EDIT LOCATE 
EDIT NEXT 
EDIT OVERLAY 
EDIT PRINT 


CLROVER 


* CP TPL 


COMBINE 05 
SPLIT 

CLROVER 

FORTRAN 16 
OFFLINE 07 
OFFLINE | 05 


MACLIS 03 
TXTLIB 


OFFLINE - 04 


{ 


3el-5~1 


XXKXX 30503-4 


3e1<6-7 
3-1213-5 


3.164-3 
3e l. 18-1 
3e1215-5 

2e202-2 

3-1-13~-11 
3.1.213~-16 
3.1.13-17 


321.13-18 
3e1213-22 


Bebe l4-2. 


3-1.i18-1 
3-1.6-11 
3.1.26-15 
3-1-6-16 
321.6-20 
3ele 6-25 
Zeled-27 
321.6-28 
3.21.6-30 
3231-4 
4Selewt—-l 
3e1.23-2 
361.14-2 
3.3-1-3 
324e2-T 
3elell-6 
Zelewll-€ 


3e1.10-3 
3-1216-3 


Zelell-6 


meee ae 


we ene ramen mn ei tea erm ot 


ERROR 


ERROR 
ERRGR 


EXECL 


FATAL 


FATAL 
FATAL 
FATAL 
FATAL 
FATAL 
FATAL 
FATAL 
FATAL 


FILE 


FILE 


- FILE 


FILE 


FILE 
FILE 
FILE 


FILE 


FILE 


WHILE WRITING 


WHILE WRITING DISK. 
S ENCGUNTERED. SYSIN REMAINS UNCHANGEC. 


TICN BEGINS... 


DISK ERROR 


ERROR 

ERROR 1 

ERROR 2 

CRROR 3 

PUNCH ERKCR. 

READER ERROR. 

TAPE ERROR WHILE READING. 
“TAPE ERROR WHILE WRITING. 
NOES NOT EXIST. 
DOES AGT EXIST WILL BE CREATED. 


CMPTY-EXIT TAKEN 


FILENAME FILETYPE FILEMOOE NOT FOUND 


HAS WRGNG RECCRD SIZE. 
MOCIF It 
NOT ChKANGED 


NOT FOUND 


NOT FCUNO ~ XXXXXXXX 


MACLIB 


TXTLIB 
CFFLINE 
UPCATE 
LOAD 
START 

$ 


DISK 


- TAPE 


WRITAP 
UPDATE 
UPDATE 
UPCATE 
DISK 
DISK 
TAPE 
TAPE 
EXEC 
GENKOD 
LOACMOD 


EDIT 


-EDIT FILE 


COT SAVE 


COMBINE 
TAPE 


EXEC 
SPLIT 
SPLIT 
LISTF 
OFFLINE 
PRINTF 
WRITAP 
LOAD 


REUSE 
USE 
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02 3.1210-3 
3.1.216~-3 
08 3eleli-7 
3.1.1774 
32263-5 
30206-2 
3.2-8-2 
03 Bele 4-3 
03 3e1.15-4 
05 3e1.19-2 
3.1.17-3 
3-1.17-3 
02 3eL.17-5 
02 30124~3 
04 3-1-4-3 
04 301215-4 
02 3el-15-4 

01 


32523-3 
KXXXX 3e2el~2 
Be2ed-l 


01-04 


02 
Ol 
01 
04 


02 


03 
04 


06 
06 
06 





32126-6 


3.1.6-18 
301.6-34 


3e1.3~2 
3.1.15-4 


329e3-4 
3e1.14-2 
301.14-2 
341-9-3 
3eleli-6 


3.}.12-2 
3e1.219-2 








: 67 
LI. 2-05-68 
; Lil. APPENDIX C-7 
2-05-68 . 
APPENDIX C. ™~ DEBUG GPR 3032-24 
ad DEBUG ORIGIN 3.3.2-29 
FILE XXXXXXXX NOT FOUND SCRIPT 08  36le13-5 DEBUG SET 3302-35 
: DEBUG STORE 3a 302-39 
*FILENAME FILETYPE FILEMODE® LOADED O1SK Belbe4-2 DEBUG X 363.2-43 
"FILENAME FILETYPE* NOT FOUND UPDATE Belel?—4 _.ANVALID CARD - XXXeeaXXX LOAD 3223-5 
"FILENAME FILETYPE* Pl LOADED TAPE 301215-2 USE 30207-2 
FILENAME NCT GIVEN. COMMAND FORMAT JS, $ Ol 30 208-4 INVALID CMS COMMAND: CMS 360.0-2 
$ FILENAME UPTICNAL ARGS _ 
: INVALID CUORE-AODRESS DEBUG BREAK 343.2-6 
FILETS) TO ASSEMBLE UNDEFINED. ASSEMBLE ol 3e4el-7 — DEBUG DEF 3.3.2-13 
DEBUG DUMP 303.2-17 
FPRS AFTER=XXXXXXXXo oe XXXKXXXX CLROVER 3e3el~4 ; DEBUC GO 303.2-22 
DEBUG ORIGIN 3.3.2-29 
FPRS BEFORE =XXXXXXXXo ee XXXXXXXX CLROVER 363e1-4 DEBUG STCRE 30302-39 
; DEBUG X 343.2-43 
FRCM USERIC: LINE CP MSG 401.9-1 
INVALID CP REQUEST cP 4e10e0-1 
F/V FLAG WRONG SPLIT 3.1.14-2 ; 
INVALID OEHUG REGUEST DEBUG 30302-2 
GPRS AFTER=XXXXXXXXe ee XXXXXXXX CLROVER 3e3e1-4 DEBUG BREAK 34322-6 
DERUG CAW 363.2-10 
GPRS BEFORLEXXXXXKXXo we XXKXKKKN CLROVER 3o301-4 DEBUG CSW 343.2-11 
DEBUG DEF 323.2-13 
ILLEGAL CARO IN DISK LOAD DECK. DISK 05 "Be le4-3 DEBUG DUMP 303.2-17 
. DEBUG GC 303.2-22 
ILLEGAL CONTROL CARD ENCOUNTERED SCRIPT 16 361013-6 DEBUG GPR 3030 2-24 
ILLEGAL DEFINEC COMMAND -= CAN'T USE *&*, €(*, DEFINE 04 305.1-2 DEBUG KX 30322-2717 
cR *',? DEBUG ORIGIN 363.2-29 
“DEBUG PSk 3302-2) 
ILLEGAL MOBE SPLIT 3010 14-2 DEBUG RESTART. 30362-32 
DEBUG RETURN 3.3.2-33 
ILLEGAL MODE CHANGE ALTER 05 3Belel-2 DEBUG SET 303.2-35 
DEBUG STORE 343.2~39 
INCCRRECT DEBUG EXIT DEBUG RETURN 3.3. 2-33 DEBUG XxX 343.2-43 
; DEBUG GC 30362~22 
INVALID LESTT SPLIT 3.1.14-2 
INCCRRECT "OFFLINE READ ** CONTROL CARD. OFFLINE 09 = 30) l-7 
INVALID REGUEST: XXXe 0a XXX EDIT 321.6-7 
INCORRECT PARAMETER LIST SCRIPY 0%  361413-5 
INVALID SCRIPT EDIT COMMAND SCRIPT '3.1.13-5 
ENPLI : EDIT INPUT 3.1.6-22 SCRIPT KEEP 3e1.13-15 
EDIT SAVE Beleb-34 
SCRIPT BOTTOM 321.138 1/0 ERRCR CN PRINTER. "PRIAT® GPTION CANCELLED. FORTRAN 3042-4 
SCRIPT INPUT 3e1013-13 A "LISTING® DISK FILE WILL BE CREATED. : 
SCRIPT REPLACE 341e13~-20 ae 
ITEM SIZE SPLIT 321.14-2 
INPLT FILE NOT IN CORRECT MACRU FORMAT. MACLIB 04 = 36 Le L046 
. ; / KELLING CMS EXECLUTICN..- i DEBUG KX 303.2-27 
INTERMECTATE FILE EXISTS. UPLATE 3e1e17-3 P-DISK: XXX RECCROS IN‘ USE, XXX LEFT (CF XXX) KX 3.5.8-1 
XX¢ FULL CCE XXX CY¥bLe) 
INVALIO ARCUMENT. DEBUG BREAK 32.322--6 ; 
DEBUG DEF 36 3.2~13 LEFT PARENTHESES MISSING FORTRAN Ol 3.4.2-7 
DEBUG DUMP 30362-17 
CEBUG GC 30302-22 ‘ 


625 


LIBRARY NGT FOUND. 
-OAC FAILED. 
LOAD PAPER HIT RETURN 


LOGGED CN AT TERM. XXX 
LOGGFF AT XKaX%eXX CN XK/XX/XX 


LOGIN OR FCRMAT PLEASE 
LOGIN NC UFD FAILEC TRY FCRMAT P 
LOGIN UFD FAILED 

LOGCFF AT XXeXXeXX ON XX/XX/KXe 


MACLIB CICTICNARY GVERFLOW —- 
TOG MANY MACROS. SCRRY-~ 


“MACLIB FILE SPECIFIED DCES .NCT EXIST. 

MACLIB FILE SPECIFIED NGT IN CORRECT FORM. 
MAX. = CF USERS EXCEEDED 

“OCE SPECIFIED FOR OUTPUT FILE IS ILLEGAL. 
MURE THAN EIGHT ACTIVE FILES-~REDUCE NESTING. 
FORE THAN 256 LIBRARY ENTRIES. SORRY: 
NAME IS UNCEFINED - XXXXXXXX 


NEw FILE ALREACY EXISTS 


NCW MUDE ILLEGAL 
NN USERS 
NO CHANGE 
NG CKANGES MADE 
NO CURRENT LINE 


NO CURRENT LINC. 
INPLT . 


O CERENED COMMANDOS 


(i 


TXTLIB 


$ 
SCRIPT 


CP LOGIN 


CMS 


CMS LOGIN 
CMS LOGIN 
CP LOGOUT 


MACLIB 


MACLIB 
MACLIB 
CP LOGIN 
COMBINE 
SCRIPT | 
TXTLIB 
REUSE 
START 

$ 


ALTER 
SCRIPT KEEP 


ALTER 

CP QUERY 
SCRIPT CHANGE 
ALTER 

SCRIPT PRINT 


SCRIPT BCTTOM 


STAT 


NO EXEC, MCDULE, OR TEXT VERSION OF FILE XXXXXX $ 
$ CCKMAND CANNCT BE EXECUTED. 


FOUAC. 
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03 


02 


OL 


O86 


06 


OT 


ul 


24 


05 
05 
05 
02 


06 


04 


02 


36 1. 16-3 
32268~-4 
3.21.213-5 


2022-2 


30509-2 
3.5.9-2 
4o1.8-1 
3.1210-4 


3.1210-4 
341.10-4 
2.262-2 
3e1.3-2 


321.213-10 
3e1.1-2 
321.13-18 


3.1.13-8 


3.5. Ll-2 


322248~-4 


NO FILE TO BE COMPILED IS DEFINED. 

NO KNOWN T-DISK 

NO MCRE ROOM, FCR USER-DEFINED COMMANDS 
NO PRIMARY NAME SPECIFIED. 


NO PRIMARY NAME SPECIFIED~RETRY 
NONEXISTENT UNIT 


NONSTANCAROD FILE 
NORMAL CGVERRIDE 


##99NOTE~-NORMAL— AND ERROR-QVERRIDES HAVE NOW 
BEEN CLEARED* 4% 


eee NOW ASSEMBLING FILE FILENAME 
NRMRET= XXXXXXXX 


CLO FILE NOT FOUND 


CLE MODE ILLEGAL 
GPEN FILE LIMIT 
OPEN FOR READ 
OPEN FOR WRITING 


GUTPLT TAPE FULL. 
CHANGE IT AND HIT CARRIAGE RETURN. 


QVERLAY ERROR 


P-CISK:; NNNN RECORDS IN USEr 
NNN LOFT (CF NNNND¢ 
ANC FULL LOF NNN CYL.) 


PARAMETER ERROR 


PARMo-LiSTHXXXXXXXXo a XXXXKKXX 


PASSWORD INCGRRECT. 
LOGOFF AT XXeXXeXX ON XX/XX/XX 


FORTRAN 
STAT 
DEFINE 
EDIT 


EDIT FILE 
EDIT SAVE 


CP DETACH 
CP READY 


SPLIT 
CLRCVER 


CLRQVER 


ASSEMBLE 
CLROVER 


ALTER 
SCRIPT KEEP 


ALTER 
SPLIT 
SPLIT 
SPLIT 
ASSEMBLE 
LCAD 
REUSE 
USE 

$ 


STAT 


UPLATE 
WRITAP 


CLRGVER 


- CP LOGIN: 
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lf 
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ol 


ol 


01 


03 


02 
02 


03 


02 


304e2-7 
3-5e11-2 
3-521-2 
30126-6 


3o126-18 
30166-34 


4e1l.3-1 
4eleli-1t 


3-1.214-2 
3436 1-3 


Bedel-4 


3e4e1-3 
3e321-3 


3e1.1-2 
1213-25 


3. 
3011-2 
3e1.14-2 
3e1.14-2 
Belel4-2 


Be4el-4 


3e1.17-3 
301219-2 


3e3e1-4% 


2e2e 2-3 


PERMANENT £/0 ERROR CN DIESKe ASSEMBLY 
CONTINUES WITHOUT WRITING LISTING FILE ON DISK. 


PERMANENT 1/0 ERROR ON TAPE 
PERMANENT 1/0 ERROR CN TAPE 

LISTING FILE WILL BE WRITTEN ON DISK 
WRITING ON TAPE IS CANCELLED. 


PERMANENT 1/0 ERROR CN THE PRINTER, 
LISTING FILE WILL BE KRETTEN ON DISK. 


PERMANENT 170 ERRUR WHILE READING SYSIN FILE 
FILENAME UNABLE TO ASSEVBLE ALL THE FILE. 


PLEASE "LOGIN LED" OR “LOGIN NO UFOS 

PLEASE REAGY THE PRINTER 

PLEASE SPECIFY DISK: PERMANENT (P) GR ¢- 
GR TEMPCRARY (T). 

Re TEXKeXX 

REAL ERROR 

REAC ONLY 

REALLY AT XXeKKX.XX CN KXSKX/XX 

REARY ThE PRINTER. 

REACY ThE TAPE UNIT AND HIT CARRIAGE RETURN 
REPLAT LOGIN 


REFERENCE TABLE CVERFI OW 


REPLACES ULD BREAKPGINT XX AT XXXXX 
SEM --- VERSION 2/5/68 


SETTING ERRCR-CVERREDE TO PROVIDE A DYNAMIC 
TRACE OF CMS (ANC CS) SVC-CALLS... 


SPECIFY "DUMP* OR "RESTORES: 
START TERMINAL TEST 
SVC~-CL D-PSW=XXXXXXXXXXXXAXXX 


SYMECLIC TAPE ACCRESS INCORRECT. 


2-05-68 6 3¢ 
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ASSEMBLE 


TAPRINT 


ASSEMBLE 


ASSEMBLE 


ASSEMBLE 20 


CMS LOGIN 03 


ASSEMBLE 
TAPRINT 


FORMAT 01 


CMS 

UPLATE 

SPLIT 

CP LOGIN 

FORTRAN 

ASSEMBLE 

CP LOGIN 

LQAD 03 
REUSE Q3 
USE 03 
$ Q3 
DERUG BREAK 
SCREPT 

SETERR 

CLRCGVER 

SCTOVER 

DUMPREST 

ECHO 

CLROVER 


TAPRINT OL 


Ze%el—4 


3e1-18-1 


3401-4 


, Ze4e 1-4 


3401-7 


3569-2 


3u401-4 
Ze1e 18-1 


30 504-2 


3.16173 
3elel4-2 
242-2-3 
3042-4 
3n401-4 


2n2e2-2 


3301-3 
321.2186-2 


Ne 


TAPE 1S NOT IN 


SYMBCLIC TAPE ADORESS INCORRECT 
LISTING FILE WILL BE WRITTEN ON DISK. 
WRITING ON TAPE IS CANCELLEO. 

16- SYMBOLS ALREACY DEFINED 

TAPE ERROR 

TAPE LOAD FORMAT. 


THE FOLLOWING NAMES ARE UNDEFINED - XXXXXXXX 


TOO MANY DUMMY ARGUMENTS. 
TOO MANY FILES 


TOC MANY LEFT PARENTHESES. 


TRUNCATED 


TYPE NOT. FOUND 


UNABLE TO COMPILE MORE THAN 32 FILES IN ONE 
RUN. PLEASE SPLIT YCUR RECUEST. 


UNABLE TO TPL SPECIFIEO UNIT TYPE 


USER NUT IN DIERECTCRY. 
LOGCFF AT XXeXXaXX ON XX/XK/XX 


UNEXPECTED UNIT-CHECK CHECKING NO. CYLINDERS 
UNEXPECTED UNI T-CHECK IN FCRMATTING DISK 
USER ‘NOT ON SYSTEM 

VARTABLE LENGTH FILE 

WRITE ERROR 

WRONG NUMBER OF PARAMETERS 


X-CISK: NNN @YL. 


~ 


ASSEMBLE 


APPENDIX C-11 


Ex. 


304.1-3 

DEBUG DEF 3.3.2-13 
WRITAP XXXXX -301219-2 
TAPE 05 361. 15-5 
LOAD 04 3.2.3-6 
REUSE 04  342.5-2 
USE 04 3.2-7-2 
$ 302-8-3 
EXEC 03 -3.5.3-4 
SPLIT 301142 
FORTRAN OL «3402-7 
EDIT ~ 3016-7 
SCRIPT CHANGE 31-13-10 
SPLIT Be} Lt-? 
FORTRAN OL —-.30422-7 
CP IPL hole? 
CP LOGIN * 2e2e2e2 
FORMAT O07 —- 32.5 24~2 
FORMAT 03 3054-2 
CP MSG 4e1.9-1 
WRT TAP 03 361.19~2 
UPDATE 3e1.17-3 
SPLIT Belele-2 
FORMAT 30504-1 


6-1-68 AL : 


CMS USER'S GUIDE 


INDEX 


A OPERAND OF MNAPPRT COMMAND 3.5613-1 


ABBREVIATING COMMANDS 36020-1 


ABEND PACRO-INSTRUCTION Be4ele2-1 


ABNORMAL TERMINATION (SEE UNRECOVERABLE ERROR) 


ACCESS Co laO~4y 261.01, 2e2cO~-], 2e2el—-l, 3ele0-l, 3el.O-2, 3-164-3, 
3.1.8-), 3.2.6 Ly 3Zo2ab-~2y 30208-3, Be4ele2—-ly Se4olo2—Te Boteo2el~ldy 


Be 4e2e1'-16 Be%e4ol~l 304040 l-2 3.5.1- stein ote4~ = 
Arora r ’ , Sel-Le 305el-2, 3504-1, GLOSS le 


ACTIVE FILE TABLE GLOSS, 2100-45 3.108-Le 30302~32, 3<4e1lc2-13, APPLA-2 


ACD GPERAND UF MACLIB COMMANDO Bake lO~Ly 30100-24 341.0-3) APP. B-6 


APE CPERAND OF TXTLIB CORMAND 3.1lelé-Ly 3oLeO-2) 3.1016-2) APP.B-7 


ACORESS REFERENCE 32220-1 
ALIGKMENT 3-4.1-1-3, Hole 4-2, GalaS-2e 4.1.13-2 


ALPHABET FILETYPE 3.5213-3,3.5.13-1 


ALPHANUH FILETYPE  3.5.13-1 THRU 305.13-3 
ALTER COMMAND — 3aLedeLy3nbeO-2¢3ebel-2y30l04-35301015~5e301e17-3, 
Se4el—2y 304.2-13, 365. I-2e APP.Ay APP.B, 32166-676.0.0-1 


ALTN CODING KEY 2e2el—4y 2e2el—-bs 20203-1e GLOSS-1 


eAP (SEE APPEND CONTROL) 


APPEND CONTROL Bo LeL3~2%, 361013-7, 3e1013-32 


ARGUNENT GLGSS, 3.156-5, Bolel?~—2, Ze2eb-l, Ze2eb—2¢ 3266-1 THRU 3.2.8-4, 
Badet by 3e3Be2~13, se3de2-22,y 3e3e2-24, 3032-29, Sa de2~35,y 3e302-39,y 
30 302-43, 324.4. 1-1, 304e4el-3, 405.3—1, 325.3~2, 3450 3-4, 4e1.0-l1, 
GeleleLe Gelo2-25 Gele3-ly Gebe4-2y SeleS—2y GebeT~ly 4eleG-ly 401210-1, 
Selell—-2s 4e1.13-25 APPLA~4, APP.B-3 THRU APP.B-S_ APP.B-7, 
&.1lel5-1, 4el.15--2 


6-1-68 2 
43 63 


ASCII-8 CODE 


Os 
7 


S 


3232-30 
ASP360 FILETYPE 3.1.6-25 3ele6~ly 36126-7175 321.6-15 


ASSEMBLE COMMAND Be4el—-lLe Bale lO~-2e 262.02 ¢ Be2e2—bs 3202-33 Jalal Br-dy 
34203721 3e4e1-2 THRU BaGel—Ty BeleLG-L,APP.A, APPR, APP.B-15 


ASSEMBLER BoSel-b THRU 3.401-5 9 3e4el—-Ty Be4elol— 34 3e4e4~2 THRU 364245~-4s 
3u4e4a1-35 3e1.19-1, APP.B~-L5 

ASSEMBLER F PROGRAMMER*S GUIDE MANUAL 3e4e1-5 

ASSEMBLER LANGUAGE 2eleO- 3, Zolet—bhe Babe lLO-Ly BelulO-2y 3e2eB-2_ 3.302-5e 
Ze4el-ly 3e4-1.1-1 THRU Zedelel~4ys Bn4ele2—1ys 3e4ele2—-3y Se4e2~-ly 
3e4%e2-35 APPLA~1, GLOSS-3 : 

ASSEMBLER LANGUAGE MANUAL 3e401-5 

ASSEMBLER GPCRANO OF GLGBAL COMMAND Be te2m—le Be 2e2—-2_ 36202-3y Bohol —3e 

664.0-1, APP.A-5 


ASSEMBLY 1.0.0-3, Be2e2—-2y 3e4e1-1 THRU 3041-5, Be4el-Te BeGole2~-1Ly 
4.0.0-1, APP.A~2 


Zele0-2, Zelel-ly 3.1.71, 


ASTERISK Be beB-Le 3ebe8-21 BelaI—-Ly BoleLl~2 THRU 
3.1.11-4, Zelell~G, Zelell-T, Belel2@-l, Selel?—3s Be2s4n-lys 3e3-2-12> 
Be 502-165 3p 402-7, Bn5n1-2, 30501 2—-by 41 


«2-ly APP.B—lbe APPLB-4 
THRU APP.B-7 _ 
ATTACH CGNSUL'E FUNCTION 4e).3-1 
ATTACHED DEVICE  4eled~ly 40 2eO-ly 40260-2) 3461.219-1 


ATTENTION INTERRUPT 
34 5e8-1, GLOSS~1 


GLCSS, QeQel-ly 3e3e2—-1Ty 3.525-1ye 3656-1, 3e5eT—l, 


ATTENTION KEY GLOSS, 2e2-l-le 2e2e1l-4y 2e2e2—-2¢ 2e2e2—-34 223-0-2y 2.3.0-3; 
Ge 2eO— le dele ll—-3,e 3e3-0-ly 3.3-2~-16,- 2e3e2~32 3041-4 30505 ly 3e5eb-le 
325-71, 3e5.EC-1, 6.0e0-1L, .620.0—-57626-0-6; 640.0-8, §.1.0-1 


ATIN KEY (SEE ATTENTIGN KEY) 
B (SEE BLANK RECLEST) 
BACK {SEE BACKSPACE RECUEST) 


BACKSPACE REQUEST = 36 be6—-Ty 20364-Ly 203.5-1y 3e1-6-34 Beleb—4y 3a 1.6-br 
Bebel3-2y 36402-8, APPoA 


BACKUP REGUEST (SEE ALSG UP REQUEST) 3.166-104 3ele6—-8y Bebeb—-1L3y 36 126-43 
UALR INSTRUCTICN 360.0-1ly 3.4.1.1-4 
BCO OPTION 2e4e2—by 324e2-25 APP.B-15 


BCOGIN CONSOLE FUNCTICN Gelel-ls 203003 p4e]e1~29 3.1.211-3, 4.0.0-1, 4e1.0-), 
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CH > - 


he 2eO-he APP.sAe 620.0—1» 6.0.20-8 


BLANK REQUEST |(3-Le6-Lls BeleO-ly3eleb—4e 3eleb~Be BaleO-13_ 301667324 


3eleb—-430 APPA 
2M (SEE BOTTOM MARGIN CONTROL) 
BOTTGM MARGIN CONTROL  301613-255 3elel3-Te APPAA~I 


BOTTOM RECUEST [EDIT ENVIR.)  3ele6-L2, 3212678 


BOTTOM REGUEST [SCRIPT ENVIR.)  301013-8) 3elel3-29 341213-6 


FOUNDARY 3.30274 THRU 3.322-6% Be de2—-lby Bede2-22% Be4alel-le 4ele4-2r 
4e1l-5-2¢ 4e1.13-2 
BR (SEE BRIEF REQUEST) 


.8R = {SEE BREAK CONTROL) 
CRANCH  304ebe2-9¢ Be4ebe2—-199 30404e1-3 
= -29 
EREAK CONTROL 30le13-269 Belel3-7— BaleL3-259 Belel3-27y Bele 3-29 
Qele13-30, 3ele13-33 THRU 3eLeL3-38y 3eLe13-40 THRU 341-613-471 APP2A~9 


PREAK REQUEST 2ede3—-le 36362-3 THRU 3,4362-99 APP.A-1 


BREAKPOINT DeBeO- 3, QadeBmlbe Sede BJs BeBe2—hy Be3e2—-2p 30302-4 THRU 3e302-8r 
Bede2—2he Bede2—-22— 32302-3324 323. 2-33 
BREAKPCINT INTERRUPT 30 302-Gy 3e3e2-21y 36302-22 


BRIEF MODE Babe6—-4_ Bebe6—-1L0, BoleGrile Baleb~-15s Bele6-13, Beleb-25,y 
Beleb-2b, Bode 6-439 301 06-33 ,APPeAmby 32126~20 

ERIEF REQUEST | 3.1.6-13_ 321.6-8, 3.126761 301.6-43, APP.A 

BSP MACRO-INSTRUCTION 324.1.2-1 

BUFFER Dele3—-2y ZelelLl~-6Gy 3e1LelL4~2% Zehele2—Ts Ze4ele2—-By Ae4ele 2-10, 
Be4ele2—lby 3e4ele2-17 

C (SEE CHANGE REQUEST) 

3.5.13-1, 305213-2 


C OPERAND OF MAPPRT COMBRAND 


C OPTICN CE FURNAT COMMAND = 345e4-1Le 3524-2 


C GPTICN OF STAT COMMAND BeSell-ly 3.5-10-2 
MONITOR SYSTEM (CHS) LeO.O—-Ly 1260.0-23 LeOe0-3y 2e0e0-hy 22120-1y 
Pere cond, 2el-0-4, 20220-ls Qelel-ly Qaelelm—“y 2etetnmly Qe2e2-3 2s2e3-ly 
2e3eO-ly BoleO-ly BelwC—2_y Bebe2—ly 3ole4-24 3eleS-le 
BeleG-L3y BebeG-1L4_ Belo Bb, BolealLO-2se Jobe li—3, Beleli-4y 31-13-20, 
Belel4—-3e BelelS—29 Balel7?-49 3e2¢2-1 THRU Be2e 2-39 Be2eB-2_ 343-0714 
Zede2—le Bede2-L2e 3030e2-13y 3e3e2-26 THRU 3302-28 30302-33539 Ba4el—-4r 


Be4el—S,y Bedolel—-ls 3a%elol-3y Jo%ele2—-b THRU Be4uke2—-Se Be4ele2—-Tr 


“CARD INPUT 


6-1-68 635 . : 


b35 


3e4ele 2-9 Ze4ele 2-10, 2e4ele 2-12 THRU Ze%e le 2-203 3040272 THRU Ze4et~“e SOR 
3e4e2~-T, 3.4.2-8, 30402-13, Be4e4-3y 3404-4 Be4%&e4el-ks Betektel—2y ; 
3e5e1-1, 3e5el—-2¢ 354-1, 325 a 42s 305e5—1, 3.5-6-1, 3e5e7T-ls 3eS5ell-le 
3.5213-1, 325.13-3, 4000-1 4eleG-l, 4el.6-1, 4holet—-Le 4e2eO-le 

621.0-Lb, GLOSS~1l, GLOSS-2, APP.A~L THRU APPeA~5Se 340.0—1, 365.10~-1; 
3o5elO0-2, 3e5el4—ly Sale lS—lLy 660.0-1Ly 6.0.0-8 oa 


CARD IMAGE GLOSS, 
36 L.6-9, 
3.1.9-2, 
3.223-5, 
APP. A-4 


3Bel.0-)s 3.1.6-l1, 3-16-23 
3.1.-6-ll, 3e1.6-15, 321.6-20, 
3e1.10-1 THRU 3.1.10--4, 
3.2.6-Ly 3.523~-1s 


B.126—4 Be leb-5y 
Bele G-254 3ele6—-32, Jel eb-43,y 
Zale lb-2,% Ze2e3-le Bele3-2y Ze2u 34 
Bu 503-2) Fe4e0-be GLOSS~1, GLOSS~-2, APP.A~2e 


Bele 6-Ts 


1.0.0-2, 3e1e11-1 


CARD READER Belell—-le 3ebell-39 Sele2—le 4els2-2y Sole T—-hy GLOSS-3, GLOSS-5, 


CARD STREAM Delbe4-2y Belell—1L THRU ZeleL1—-3y Zelbell—-6y 364e4e1-1 


CARREAGE CONTROL Belall—-Ly Belbalim2s Belel19~-by 301.19-2 


CARRIAGE CONTRCL CHARACTER 


ZeleO-2, Belell—-ly BoleLI-2, Beleli-Se Bele lly 
344.2-8, Be4n2-lC, 


3e4.4-1, Sa4e4el~2 


CARRIAGE RETURN GLOSS, Poltel—4s 2 2elsbs Ze2e2m2y Ze2u2-3y 2e2e3nly 2elaS~l, 


BabeGrby Bebub-3y Bole l3-2 THRU Zobel 3-4y 363e0—-Le Se3e2-be 36362-1001 
Be de2~L1y Be de2-13 4 Be de2-1LTy 30302-2245 Bade2—24hy Badu d—2by Be 302-294 
3n3-2-3h 34342-33, 34362~35, BeB02-394 Bere2-43% 2e4e 1l- 4 Ze4nhel-2y 


Be5e4-by 4e2.0-1e GLOSS-3, 3,.0.0-Ls 420-0-1 


CAW (SEE CHANNEL ADDRESS WCRD) 


CAV RECUEST Bede2-ly 34302-3, APPBLA 


CCW (SEE CHANNEL COMMAND WORD) 


o CE (SEE CENTER CONTROL) 


CENTER CONTROL BobeL3-27- Bolwl3~-7e Jal. L344, 321013-45, 3e1213-47 


CENTER OPTION OF SCRIPT COMMANO = 3e1+13-1 


CENTRAL PROCESSING UNIT (CPU) = 160,0-1e 36342-30,5 4e1.6-1, GLOSS-2 


CHANGE RECUEST (EDIT ENVIR:) 


BeleO-L4e Bela6—-42 301.6~By 
3-16-41, APP .Ae 


Beleb-1l3, 3126-20, 
Behe 6-15, 3.41.66-43 ; 


CHANGE RECUEST (SCRIPT ENVIR») 3e1.13-9, 301213-6y 321413-10 


CHANNEL BeBeQ—Lly 3e5e4-2y BedeSmhy 305e6-1y 305e7-1y 3.5-8-1 

CHANNEL ADORESS WORD (CAW) BeBeO-Ly B4302~1e 36342-10, 34362-21y 32322-34% 
Bode 2-35, APP.A-5 

CHANNEL COMMAND COCE 3.bell-2 


CHANNEL COMMAND wORD (CCW) 


Belse2-ly Zelell-2, 3Zelet1l-6, 3e3-2-10, 3.3.2-1) 
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CHANNEL END 3.5.4-2 


CHANNEL STATUS WORD (CSW) 3-3.0-1l, 3302-1 Bede2~-l)ly 3302-21 30362-34:¢ 
30 302-35, APPLA~5 


CHARACTER-DELETE SYHBOL(Q) GLOSS, 20203-1y 60060-64 Jeleb~3y Jele13-2 
3e3e2-25 Be4ele2~lby Se4ele2—l?s Be4e4tel~2y ZeSe2—-ls 34565—1L>s 3.5.6-l1, 
3-5e7~1, 325-8-le 421.0-1 

CHARACTER SET 2e2e2-1 
CHECK KACRO-INSTRUCTION 3e4ele2-1 


CKEOF RACRO-INSTRUCTION Bekele 2-9, 3e4e1-2-1 THRY 3e4elw 2-3 Ba4ele2-Ts 
3e4e1.2-8 


CLEAR OPTION Be 203-1 34223-25 APPLB-15 


CLOSE CONSOLE FUNCTION Gele2—Ly Sele Sm 2s Fe4e4el—2y 4eleOmly S4ele2—~2y 
4. 1-8-1, APP.A-]1 


CLOSE MACRO-INSTRUCTION  304.222-1— 


CLOSING FILES 2elC-4s 3-1.8-1> 3e1.B~2, Bele lO~4>e Be2el-2s Berean 2y 


3.2.48-3, Fede 2-2Ty BeGelel-Lly Zetrele2—2¢ Be4ele2-13, 304028, Se%e 2710, 


3.5.6-Jy hale 2-25 4eleS~2y haleBmly APP.A~2 4 Bele l3—-6y Zelel3-24, 
-3e1213-32 


CLOSIO COMMAND Bele2—-ly 3ele0-25 APPaAy APPLB 


CLROVER COMMAND BeBel—-Le 303e3—Ly 303.0-1y 3.3.1-2 THRU 3.301-4, 
Be 304-3, Fe5eG-lLy APPsAy APP.B 


CMS (SEE CAMBREDGE MCNITOR SYSTEM) 


CHS CARD FORMAT BeleO-ly Bebe4mdy APPLA-1 


CMS COHMANOS 2e30e2—1ly 26320-) THRU 243260-3, 3eOeO-le 3e000—-2_ BeLeO-]}y Bele 2~dy 


3.1.8-1, 3e2e0-ly 3.2681 363-0-1Ls Bese 23a Bae4elal—-3s Zakt@ele2-ly 
3e4ele 2-12; 3e5.l-le 3e5el—-2, 30523-1 THRU 3253-4, 3e565-14 Bebelnrhe 


BaSaTmly Be5eB- Ly 3e5.10- de Be5elG-ly 4eOeO-Ly SelaO-lLy GeOeO-1y GLOSS—1ly 


GLOSS-4, APP.A~2} THRU APPeA-%, APF By APP.B-3_ APP2B—4, APPLB-15 


CMS COFMAND ENVIRONMENT Zu 2a2731 2032e0-1y 2030-34 3220.0-2, 2e1.6-18: 
‘BeleG-3ly Jelok3--2 THRU 3e1013-5y Belbel3-7s Jelel3—lLly J3elol3-12y 
Bele l3~1L9, Selah 4—-3y ZelelI-4, Bele LB-l, 30 302-5, Bede lm2hy Bade232% 
3.3.22-335 3e3e4—3e 3a4ele2—-Fy 304e1.2-103 aeSe2—-]s 3055) 325eb—-le 


3.5.7-1Ls 3.5.8-1L, 3.5.9-1, 3.5.10-2, 3.5214-1L; 4elel-l; 4e220-1, 5§.1.0-l, 


GLOSS—4, APP.A~le APP.A-3, APP.LA-5S THRU APP.A~8 
CHS FILE SIZE 2e1.0~4 
CHS FUNCTIONS GLOSS, 323-0~-1ly 3e4ehel~3y GLOSS~4 


cms INITIALIZATION 2e2e2-3» BeSel3~2e3eleT—2, Je2e2~2y Ze2e2—-3r 363e2-26, 
( : Bede 2-329 4e2eO- de Se4eO- ly 5e4e0-2y APPLA-5 ; 


. 
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CMS LOGIN (SEE LOGIN COMMAND) oe 

CMS LOGOUT (SEE LOGOLT COMMAND) 

CHS MACROS 364.1-2-1 THRU 364.1.2-20 

CMS NUCLEUS ", GLOSS 1,000-34 2eleQ-le 2000-29 2202-33 Be2a2—2e 3020 2~3s 
Z.302~2by 30322-32, Ze4alelonls 2.4ehel—-4, 3e64e122-19, 3.5.1-1; 3521-25 
3.5e13—le 3e0.C—1l, 3400-2, 3e5e1L3-2 3e5e14-l, 5e4.0—-1, 5 2420-2 
GLOSS~12+ GLOSS~4 

CMS-NUC FILENAME 345213-1 THRU 325.13~3 

CHS PRCGRAM LOGIC MANUAL Ze4elel~-3s Be4ele 1-43 3442142-20 

CMS SERVICE ROUTINE 2e3eO~1Ly ere E Be4elel-l, Ze4elel-3 

CMS SUPERVISOR CALL (SEE CMS SVC} 

CMS SVC 20360-34 36300-Le 3e301-32 3e3e1—4y Bede3—Ly 3e3e4—]y 30304 2s 
20309- 1, -323-0-1; 3031-3, Be3el—-4s 3.3.3-l, 3030373) Zede4-le 303042 
dade 4m, 3.4eheb--3, 364 1-4, B.4elet-ly Sahel 2-2, Ze4elet-Ty 
3e4ele2-14, Ba4deled-los Be4el.e2-193 3463-43-73 

CMSREG MACRO-INSTRUCTION Se4e1.2-1By 32461-2-2 

CASTYPE MACRO~INSTRUCTICN 30421-2-15 

CMSYSKEF MACKL-INSIRUCVICN DeholeZ—lL9Oy BaGel eo 2-204 Bahela22ey Bole l3-22 

COLUMN DELPLNOENCY Belsb~-20, 341.6-25 


COMBINE COMMAND 3ele3-le 3ol.4-3, 3.120 2s Zelel—-l, Zelel~2y 3-1e3-23 
Ze 10.15-4y Bele 15-5_ APPeAy APPeA~Ly APPLE > 


CGMMANC CARD Belell-2 

COMMAND ENVIRONMENT (SEE CMS COMMAND ENVIRCHMENT) 

COMMANQ NAME 3.0-0-1 

COMPACTING ROUTINE BeSell-dy 345-10-1L, 345210-2 

COMPIELATICN 1L20.0-3, 364e2~-1 THRU 3e%0 2-4, Be%e2—-Ty Be Sahm le 304042 


COMPILER «= 3042-1 THRU 36402-4, 3e%eG—-1 THRU 30424-3y BeSehel-2y 304e%e1-3 
5500-5, APPeA-2y APP wB-155 3e1219-1) 


CONCATCNATION Belel-2_y APP.A-1 
CCNDITION COCE Bede2-21, 36564-2 
CCNSOLE (SEE TERMINAL) 


CCNSOLE FUNCTION GLOSS, 4eOeMm de 4a2eO-be 2e2e2—-Le 2e202-35 2e2e3-1e 2.3.0-1y 
223.0-3) 350 I~] 6.0.0-1, Z.lell—-3, Zede2—-ly Betetr2ly 4e1-0-ly Sel 3-le 
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4ale4m-2s hele4~3 4el.5~-2, 4el.5-3, SeleTrle 4eleal3—-2e 4o2e0-24 GLOSS=1 
THRU GLOSS=4-— APP.A-1y APP.B-15, 345.10-2 


CONSOLE TYPEVRITER (SEE TERSINAL) 


CONSOLE USER 1.0.0-2 


woe 


CONTINUATION CARD 3e1.6-7 


CONTRCL CARD BelelLl-7y BelelT-1 THRU Bolel@—-4,y 3e4e4-1) THRU 36424-3¢ 
Be4e4. 1-3; APP SAn4 . 


CONTROL CHARACTER Ba l.d1-6 


CONTRGL PROGEKAM (CP) 120e0-ly, 1-0.0~2, 1-0.0-3, 2-0.-0-1, 2elvO-ls 2e2eOnmly 
Zetolrle Aa2el-4y Qudetris. 2a 2231 Qeterm ly 2o3eO-be Bobo2-le Bele4n2e 
DobaG-3, Beledl- 2y Beleli-3e Belell—-Gy Bolodh--Te Be 2e2-2y Be2e2—-3y. 34n320-21 
3-3.1—-1le seZda3rly Bade 3 354m ey 4e0.0~1l, 4aleOn~}s 4ale2-ly 4olo3n-ly 
4eln5-24 4eleb-ly 4eleT~-ls 4e1210-1? Ge2eO-24 Sel Ol] §aGeOr-], Bete D-2y 
GLOSS~1 THRU GLOSS-S_ APPsA-Ly APPcB-3y Selel-2y BolalB-dy 3e1619-1, 

Bede lO-1Ly 3265.10~2, 3.5.14-1, 620.0-11 620.0-8 

CONTRGL PROGRAM CONSOLE CUNCTION (SEE CCONSCLE FURCTION) 

CCONTRCL PROGRAM EMVIRONNENT  2.6202-3) 203e0-1 THRU 20360734 30%. 10-2) 3.5e10~2, 
2edet-)e 2an2re3nmdy Pedeh-ly Pere Sly Je Ac b~-)e Zotal~ Sy 2ede ly 20 309~]e © 
Bede2-1L2y Bade2~lLbe BaBe2-27y BehMol—-4e BeHeS—-le BeSeGrhy ZB.5e7—-ly 305081, 
GeO.O- 1s Sele Orbe Sebel-Le 4eleGmle 4e200-1L, APP.A-3, APPLA 5S 


CONIRCL SECTIGN ° GLOSS, GLOSS~2, GLOSS-3 
CONTROL SECTICN HAE Belel6—1 THRU 3elel6-4_ Be2el~le 3e2e3-khs 3e203-6) 
36 205-25 Bu 2eb—hy Jadu 2y Be2a lm 2y Be 208-2 THRU 362. 8-49 4632 0-4, 
5400-2, APPLAW4_ APPLR-3 
CONTROL WORD #1, 14653 Bebel 3-5 Belel3-15 THRU Selol3-27_ BodeQ—le Bade Qeiy 
CONVENTIONS 220.0-14 201.0-Le 20202-39 2e2e3-1Ly 223.0-1 
CORE (SEE CORE STORAGE) 


CORL-ITMAGE FORM | 342.0-he 3201-1 THRU 36201-3— Je2e4~-Ly 3eG5ek-le 365.1) 25 
APP.Am2 THRU APPeAm4_ 32020-1s 320.0-2 


CORE LOCATION 4e302-24 30 3.2-5 THRU 3.302-7Ty 3e 302-10 THRU 34362—-169 346362-21 
THRU 34322-7239 36340 2-28 THRU 34302-30, 36302-3229 3632-38 THRU 3630240, 
Bede 2-42, 40302-43¢ 4elel-2 


CORE RESICENCE 1.0.0-3, 3.2-0-11 GLOSS-1 


CORE STURAGE LeiQ.0-1, 14000-2825 2202-3 y 36060-Le Bobo 3- 2, Behe L1-Gy 3e1012-3, 
3e2e0—-Le Zelel~ly B.2el ee 2.27037], de2a 32s 3203-5, Sela rhy Ae Qe dy 
De 2eh-2y Bato t—Le Behe b- fe Be2eGr-hy BePab-2_ Be2et— ley Belo l—2y 36228~1h 

° THRU 3e208-34 326360- Le 3.321-3, Bode l—ANy 323. 2-5y BeBe 2-Oy Bede 2-104 
303462-16 THRU Bede? VG, Bede 2hy 3e302-32% Zede2—42y Bade 2-43, De deh 2¢ 
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4 L.2-1Ll, Beh e4m4y 4-0.0~-1, 4alel-jy 4.1l.4-l, 


e 3642 
1.5-2, 4.1.213-1, 4e1.13-2, APP. A~5i, APP, B-—3, 


wl w 


o4ehel- e Be4ela 
elal-2, 4-1.5-l, 
0909-2, 6.0.0-1 
cP (SEE CONTROL PROGRAM) 

CP (SEE CURRENT PAGE CONTROL) 

CP/CMS SYSTEM GLOSS, 2e2e2-Ly GLOSS-2) GLOSS—4, 3.5.10-1 


cP page re ALSO LOGGING IN) 262021 THRU 202.2-35 Belell—3_ 3ehe4el—4y 
-4 


CP LOGCUT (SEE ALSO LOGGING OUT) 2.2.2-3, 202.2-1, Be2e2—2y 36202-3, 
303e0-1, Zadel-l, 30303-1, 303043, 4e1.2-2, 4eleB-L, 4.2.0-1, 5.4.0-h+ 
325.10-1 

CPU" (SEE CENTRAL PROCESSING UNIT) 


CPU TIME GLOSS, 1eC.C-1ly 34362-3259 34302-33) Bs4elel—-l, Bo%e2—-lly 
304040 1-49 365e13-24 GLGSS-2, GLOSS—4, 3e5el0-2y 3465-10-25 SolelS-ly 
4elal 5-2 ° ; 
CROSS-REFERENCE SYMBCL TABLE Bottal-ly 3e4el-2¢ 304015, APP.B-15 
CSw (SEE CHANNEL STATUS WORD) ~ . 
CSh REQUEST 36302-3, 34362-L)l, APPLA 
CURRENT PAGE CONTROL 3e1013-28, 351.213-7 
CURRENT LINE Bole6~4y 3obe6-10y 3eb.6-11_ 30106-14 THRU ZeleG-1bT, 34126728 
: THRU 3e2.6-305 361.6-32 THRU 3.106-34) Belbel3—-3, 301013-9 THRU 3el.13-11, 


BeleL3-17?_ 3eLe13-23y 3e1Le13-18, 361413-20 THRU 3.1.13-23 
CURRENT PSW Be3e2-21e 36342-2353, 34342-36 


CYLINDER = 321e5-Ly BebeS-2_ Bade2-27y 3Be5e4— Ly 30504-2¢ Be5ell—1 
C (SEE DELETE REGUEST) 

C OPTICN QF STAT COMMAND 3e5e)h1-1 

CATA CrECK Kty 2etel~6 

GATA-PEONE = 202.0-by 24260724 2etel—ly 26202-1 
CATA SET REFERENCE NUMBER 30402-8 THRU 364e2—-Lh¢ 3u4e2-13 
ECB MACRO-INSTRUCTICN  34402.2-1 

CCAD MACRC-INSTRUCTICN  3.4.1.2-1 


ECBUG COMBAND 2edadmly 2e 32 O~-ly 2030-3, 3.-3.0-1, aede2—ly Bede2n2y rede lr, 
Bede 2-220 Be 30 2- 33y Ge leU-2y APPoAy APP.B 


LtEBUG ENVIRONMENT 2o3eO-1 THRU 263.0-35 36300-1y 3e3el—by 36302-1 THRU 
3362-44, Be 3.3 hy 30304-3y Be4olwl—3e Golal—lhy Bebsl3-S- Seleb-ly 
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Ge2eOr- ly APP .LA-5, APP. B-3 


CEBUG REQUESTS 3.3.2-1 THRU Be302-3_ 30302-6e 36322~10 THRU 3.3.2-13, Bade 2-244 
3e3e2—26 THRU 36322-29¢ 36302-31 THRU 30302-3345 36302-359 323. 2-39, 
Be 302-434 4elbaG-Le APPeAe APP.B, APPeB-3y APP.B~9, 4elel—-ly 3.1213-5 


CEBUG SYKBOL TABLE Bee 2-Be BeBe 2—he 36322--6y BeBe2—-12 THRU 3e322-14, 
3e3e2-lby 3.3.2-17, 3e3e22-2) THRU Bede2n23e 3e3e2-26, 34366-28,% Zedel-29y 
Be Be2~38y 34302~39y Ba302—-42y 30302-43 


CEBUGGING 3e3e0-1ly 160.0-3, 343.2—1, Ba4e4el—-3_ 462.0-1) 3.0.01 


CECK OPTICN Bedel-ls 3eGe2—-Le Behel—-25 2a%4%e2—2e APP.O-15 

DEF REQUEST 3e302~3,7 Bede2—4e Bndel—by 3.3.2-7, 30322-13 THRU 
36 3a2~15,y Be 3de2-1lTy Ze3e2~21y, Be2e2-Z224 Zede2—-26y Zote2-2By Bede2-29, 
32302-38, 363.2-39— 30302-42, 30302-4345 APPLA 


CEFAULT ENTRY POINT GLUSS, Bete 3-4, 3.2.0-1, 3205-1, Ba2eSnm2y Be2eb~-ls 
Be2eT—ly APPeA~3, APPLA=4_ APPLB-3, APP. B—-7 


CEFAULT OPTIGN ; BeleG-23 BeleG-5y B.b06-7_ Bele6-10) 36406-12 
3.1.6-22, 3e1.6-25, 321.6-28, 3.1.-6-30, 3el-6-31, Bale I-ls Belal3-by 
201013-9, 3.1.13-10, 3-1.13-15, 3e1.13~24, 3e1213-25, 3-1.13-27, 342-0—), 
30203-2 THRU Bele3~by Bede2—-1?, BeB.2~-14, Bede4-lh THRU Bae nGn Sy 3e4el-2, 
Ze%el-5, Zotalba2-l7y 3.4.2-2 THRU Zeh%e tn 4y De4e4—lLy Bade2—1,y 3.5ehi-l, 
3.5.13-2, 4elalt-}, APP.A~G, APP.AWG, APP.By APP.B-3, APP.B-15, APP.B-16 
4elelo-l, 4-e1.15-2 . 

CEFAULT VALUE {SEE DEFAULT OPTION) 

CEFINE COMMAKD BeSelmly 3.501-2) B.5e11-1, 3,5012-1y 3e5e2l2-2,4 
APP.A, APP .A=4, APP.B 


CEFINE REGUEST (SEE DEF REQUEST) | 


CELETE CHARACTER (SEE CHARACTER-DELETE SYMBCL,y LINE-OELETE SYMBOL) 
CELETE RECUEST (EDIT ENVIR.) BaleG-16y 3ele6-1L7e 32106-45 321.6-B8, APPA 
CELETE REQUEST (SCRIPT EDIT ENVIR.) Belel3-Lle 341.13-6 
CELETE SYMBOL SCE CHARACTER-DELETE SYMBCL AND LINE-DELETE SYMBOL 


DELIMITER 2023-14 3e1e6-24_ 30 eb~16y 30be6-25y 3e1013-127 301013-9, 
Bebel3-169 BeLeL3-20¢ Sebo13-2l_ Be4ebel—Ly GeleO-ly GLOSS—3, APP.B-1 

CELIMITING CHARACTER (SEE DELIMITER) 
CETACH CONSOLE FUNCTION 4eleO-ly 4ela3-Ly 4e200-25 APPLA 
CEYICE ASSIGNHENT  324.2-139 402.0-1 
CEVICE END 305.42, 4ebell-1 


CraG OPTION Ze4elmbe 304e2—-1e 3e4el-2e 304e2~2— APP.B-15 
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CLAGNOSTICS 3.4el-1 THRU 3.9.1-35 3.4.1-5, Be4al-by Bote2—Ly BeM%e2—2y 3a4e4—3y 
APP .B~15 . 


CICTICNARY SelelOm1Ly 361610~-4¢ 361¢16—2 THRU 3.1.16-4) APP.AW3, APP. A~4, 
GLOSS-3, GLOSS-4 


DIRECT ACCESS FILE Behe2—Lly 34402-12 


HIRECT WIRING 262.0-hy 262.2-1 

CIRECTCRY (SEE ALSC PERMANENT FILE DIRECTORY, SYSTEM FILE CIRECTORY, 
TEMPORARY FILE DIRECTORY) ZeleO~2y Belsl-2y 3ele4—]y 3005-1, 
Belel6-3. Zale? Le 3e1.7-2y S.1eB8-ly 361.9-le Sebel 5-1 THRU. 3e1.15-5,5 
Se4ele2-5, Zot%elel-by Se4e2-Ty 2e504~ly 2eSel2-1; 4e200-ly §e1.0-ls 
GLOSS-1, APP.A-2, 3.0.0-ly 365-10-1 


CISK CCMNAND Belefmly Jelbe2—-1Le APPeAy APP. 


CISK FILES 3.2.0-1) 341.0-2, 3ele3~ly Bele4d—)y Belch 3B~-le BeL.13-3) 3ele15—ly 
Bele l5--4, Ze4ele2-]y Ze4ele2—4y Botoled-by 3e4el.2-10;, Beh@elet—-l2s 
344e162-135 364.2-4, GLOSS—L THRU GLOSS~3_ APP.A—Le APP.LA-3, APP.A-4 
305.9-1 | 


LISK RESIDENCE 1.0.C~3_ 201.0-L, 201-0-2) 3.2.0-1, Bohelnl-%_ Be4ele2—de 
BeSel-2y 5e4e0~-ly 504e0-25 GLOSS-4, 3.0.0-1 

CISK UNIT (SEE DISK) 

CUSK USAGE 2aleOr by LeQ.0-%y 2elmO—-%s, 202,2-3y Beli O-ly 3e1.0~?, 
Bebed-Ly Bebe 2 by Bede dhe Sele3-25 Bebeh—-} THRU Bele4-3_ Zele5-1ls 
JeleG-by 3ebe6-4 THRU 201.6—6) Be) eG-L3y Beleb-14_ 3e1.6-26, 3.1.7-)Ly 
Bele 29) 3e1.28-1, 361.9%] THRU 301.9-3, BelelO-?2, 3e1610~-3, Beleli-7y 
ZBelel2-2y 3ebel 3-3) 3elel3—5y 361.13-7, Bebol3-Lly Selbel4-ly Bebek4—2y 

LelLO-1 THRU 3. be b5-5, Bebe L7—-33 Be2eO-ly Ba2al—-24 Ba2el-3e 302. 3-Gy 

Sate dy 2e2-4-2— Be2e5a be Be 2eT—Lby 36502-26y 34302-32y 3e%el-3 THRU 

1-5, 3.4e]e1-1, 3e4el,1-2, 364.122-1, Zehale 2B, Ze4el.2-Ll, 3640 2~4, 

2-~lhe Be4ua4el—ly Zeofo&eS-ly 304.5-2, 35a BL DeFell-ily 3.5e-11-2, 

O-L, GLOSS-1 THRU GLOSS-4, APP.A-2 THRU APP.A~4 


CISPLACEHENT 3.2.6-Ls Be2eob—-2y 36268-2, 3208-3, Be4ulel-4y 3e4e1.2-19, 
30401. 2-20 


CISPLAY CCNSOLE FUNCTIGN 
APP.LA 


4.1.4-1, 3e3a2-l]y 4.1.0-1, Gale 4-2y 401.4-3, 

COUBLE SPACE CONTROL 3.1.33-29, 3e1e13-7y 3e1e13-41y 30h el3-42— 3e1.03-44, 
3.1213-464 APP.A-9 

-CS (SEE UCUBLE SPACE CONTROL) 

CU (SEE DUMP CUNSOLE FUACTION) 


fume CONSCLE FUNCTION hele S-Ly BaleSmle 3ed.5-24 4SeleO-ly Sele 2-2, 
4e1-5-2, 4e1.5~3, APPA . 


CUMP GPERAND OF TAPE CUMMAND BelelS-1l, 322-0-Ly 3e2.15-2 THRU 321215-5, 


APP.E-7 
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LUMP REQUEST Delet~Le BelaS-by 3eleS-2y 3e3e2—3¢ 3032-15 THRU 
3032-20. APPeAy APP.D~3 
CUMP OPERAND OF DISK COMLAND Baledm~le BebeO-lLe Bele4—-2_y Belet~3,y APPAD <4 


CUHPING CORE 


Be BeO~Ly 36362-15 THRU 36302-2059 SeDeO-de SeleS—-1 THRU 4ebe5-3y 
4e2.0-1 : 


DUMPREST COMMAND BeleS—le BeleO-ly 3ele2—Ly 3ele5—-2_ APPaAy APP.B 
E (SEE EXTERNAL CONSOLE FUNCTION) 

EBCOIC CODE BeBe 2-30, Ba4elel—ly 30404-3 
EeGCcoIc OPTION Zahe2—Le 2eleO-hy Setelr2y Ae2e2—-le Bulo4rm2e Fahe2~2e APP,B-1L5 


ECHO CCKMAND 
APP.B 


2eSa2—Le 2a3e0-Le 2050-32 Bebab—-3By BaSe2~-2e FeleO~2y APPuAy 


‘ECHO ENVIRONMENT. 2320-1 THRU 26320~-35 34522~1 

EDIT CCNHAND Belebr-ly 1.-0.0~-3, 243-0-1, 20320-3% BaleOr-ly 3elc0~2, 
341<6-2 THRU 3.1-6-43, Za4w2~Ty 305e3-}5 30 523-3, Bee 3-5, Sel»O~-), 
APPwAe APP.By APP.B-3 


EDIT ENVIRONMENT 2@.32.0-1 THRU 2.3.0-3, 3eleG-l THRU 3.2-6-7, 34126-13, 
BeleG-225 2e1013-44 32 5013-2, 6.020-2 ‘ 


EDIT OPERAND OF SCRIPT COMMAND  3eLe)3—Ly 3ebwO-Ly 3ebol3-29 Belel3~5y 
Zeleb3-Lly. BeleL3- 14, APPLB-G : 


ENIT REGUESTS BeleOrly 3aloG-D THRU Bele6-7y Belsb-By Belol3-4ye Belo l 3h 
APPsAy APPeA-6y APP weA~7T_y APPeA~LO_y APPeA-11_ APPeiy APP.B-9 

ENC OF BLOCK (FOB) 2e2elr-Sy QeZolmbs 2e203-Le GLOSS—-1 

ENC OF FILE (EGF) Zele2-ly Beladr~le Jole4—-3y BolbeGrhy Beleb—-5e Aelob-Ts 
BeleGrlly ZeleG-14 THRU ZoleOri7y BeleG-20y JoleG-25¢ BeleG -27%_ BelbeG-2By 
3.1.6-30; 3e1.6-32, B.beGn~4ly Belell-2, Bealeli-3y Zelel2—-ly Ba.lel2-2, 
Belal3-4_ Bolel3-61 3o3013-9 THRU Belel3-Lle Belel 3-13, 361213~16 THRU 
3.1213-18, Belwl3-22 Belol4-ly Zelel4-2, Z.1.15-L, BelelS~2, Bel 18-1, 
Belwl9-ls 3e4el.2-35 Ze4ele2-T THRY Zeotela2—-Gy hels2-lLs APP.B-3 

END OF REEL (EOR) BeleolS-4y Selelo-S,y Jetel 4 

ENTRY POINT GLOSS, AeleLG—L THRU 3elelL6—45 Be2eO-Ly Be2-l-ly 36201-25 Bo2e3-le 
Bete 36s 32205-25 Soteb-ly Be2ebm-2y Be2eT~2y Be2eB—2 THRU 3462.80-4y 
De4elbelm de. Ba4edalr—4e Beebe 2-3V9— Bote 2—-3y Bebe 3—-1Ly 345613-2, 5.5.0], 
5040-22 GLOSS-3, APPLA-4_ APP.B-3_ APP.B-5, APPLB-7 


ENVIRCNMENT 2edeOr ly 2eOe0-le 2e2elmly 22202-39 20300-25 32206-1 THRU 
Bebe6-335 Bele L3-1 THRU 361413-49 343,.2-L2 THRU 343-2-5, 3.3.22-12% 
Be Be2-1L3s 34396 2-22_ 34322-2359 36302-26— 34302-27, 303-2-32 THRU 323.2-36, 
4.0.0-ls 4n.l.0-1l) 4.lel-l, 4elet—-ly 5.1.0-2, GLOSS, GLGSS—I, GLOSS~2, 
GLOSS-4 





b¥z, 


bs 


ENVIRCNNENT TAANSFER 


EOB 
EOF 
EOR 
ERASE 


ERASE 


ERROR 


ERROR 


ERROR 


ERROR 


EVEN BOUNDARY 


EXEC CCMMAND 


EXEC OPERAND GF LISTF COMMAND 


EXECUTION — 
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b73 


BeBeZ-Sy 3s302-16) 3302-239 3e302-26y 303-227, 
3o302-32 THRU 34302-34— 3e5e5—Ly 3e5e6—-by 3e5e?-] 

(SEE END OF BLOCK) | 

(SEE END OF FILE) 

{SEE END OF REEL) 


COMNAND 3eleT-ly 301202, Belel-2s BeleT—3e ZelelT-3, 3641-3, 3e4e0l~4e 
364e1-7) Ze4ele2-L2e 5e1.0-2, APP.A, APP.B 

MACRO~INSTRUCTION Be4eln2-L29 Be4elod—Le Behelad~2 

E BelulrLe Zelelr2y Bebe B-2_ Belet—-1Le BeleT—2y BelbwB-ly 

8-2, Bele~9-3e 3elel0-3, 3.1.10-4, Zelell—-6, 3.1.11-7, Zelel2-2, 

13-Sy BolelS—-%y BelelS-Sy Be2al—-2y Bela l—3y Be 2@e3A~ Gy Bate hr-ly Bo2eM~ 24 
B-24 Bate 2e Be2etHlsy Be2et—-2_ 20 2e8-2y 3228 Ne 363.0-Ly Bedelb~3y 
1-4, Be 302-33, 3e3e3~-1, 3.3-3-3) Bede 4-7 5e4el1—-1, 2e%el—3e Z.4el~4y 
i 

1 

3 

! 


—Ty Babolal-Ly Bo4alel-2_ Jatele 2-3, 3e4e1e2-G6 THRU 3.4e1b42-by 
o2-lOy Be4u le 2-20, BeAa2—23 Beet he Be4e2~-Ts 3a te4m4s 3501-29 
~2 THRU 5.56 ay ea coe a) 3.5,12~2, 5e1.0-1, GLOSS-2, APP eA~4_ 
9-29 341.413~-6 


WW Ww WU wew OW OF 


COMPLETION CODE (SEE ERROR CODE) 

KESSAGE GLOSS: 20leO-Ly 3u0.0-22 Belel-ly 3elein-2y 

Bebet—ly Bebe 3-2, Bele4r-3y BebaS-2_ Beleb-6y BeloG-13, 3e1.%-25 Bal. 82s 
BeL.9-3, Beh LC-2 THRU 3.1.10-4, Beloli-6e Belell—-7, 3elel2-22 361-13-5, 
Bele L4—-1L THRU Bebe body Bele l 5-4, Bele lL5—-5y Belelb-3s JelelG-4s 3olelT~2y 


ZeolelL?~-Sy 3,1.<16-1, ZrlelB-?, BelelG-2, 

See lm 2e Bel e233, Bete BrHy BePat~ ly Beater 2y BaP edn- Fe BoQe hr 2y 

Deke Trdg Bale Tm2e Be2e Orde Bedelr4y BeBe B-Be Bedeh- Te Be4el-Le Bohol Ty 
BaGolel-2y Be4elo2—-Fy Bate lu 2—-F_ BaGele2—10y Batol e tr 1L54 3e4e2-2 THRU 
Behn d—4_ Babette Satur 3e Baten he BeGel—-2y 3e5e2—-Ly 34563-2? THRU 
2.5.8 A, FeDe4— ly Cra e Cr ay Bebe dol, 3eSbebmrhy 3.5,7~-)s 3.5,8-1l, 3.509 26 
BaSelLO~ 25 Be5e Ld 2y Be5el2—-2_ BoSel3-2y Be5el4—ly SeleG~ly GLOSS~2,_ 


GLOSS-4 


OVERRIDE 3e3.O0-L, Bu dol-Ly 3230ebL-3y Be e1-4¢ Bade 3—-3y 36324-2 THRU 
30 304-42 APPLA-4 ; 


(SEE HALF WORD BOUNDARY) 


Be2.O-1y Be5e3—Ly 361.9-2) Be2eBrby 30208-2) 30503-2 THRU 
3e5e3—-by SebeO-by GeOnG-ly APPAAy APP.A-3y APPL 


BolbeI~hy Bebe G—-2 THRU 3.212.9-4, APPLA-3, APP.B-5 


3.200~-Le Be 2e0-2y LeOVO-2y 14060-3, ZeleO~-22 AaleO-4,y 223.0-)y 
203.0-3, 3.1e8-le 4Salal~-2,5 NeleTo-ls 3.0.0-1l+s 3.0.0-2, 3.5.-10-1, 
Zelell-3e Jele 13-2 THRU 361413-4, 3-1613-6, 361-17-2 THRU 3.1217-4,) 
Be2te2—he 30202-3y 30203-2 THRU Be2e3-Gy Be2eb~-1y Bato b~2y 32268-) THRU 
228-4, 30 300-ly sade l-4e Bede2—-ly BeBa2-2y 34362-4 THRU BeBunl-Te 
3Be2-21 THRU 34342-2345 30 302—-3le 3e3e2-3l—e BeBeGm dy BedsbsZy BeGalk—4y 
4al-Sy 3e4e1-71 3e4olel—-) THRU 3.4elet-4y 3e4e1e2-1 THRU 3.4.142-31 
Sele 2-5 PURU Be4e le 2-74 Boba l a 2-9, Behm la Q— Ve Baha t—-3y Be4n 2 Te | 
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3422-8, 30422-1111 THRU 3e4e2-L3,y 304041 THRU Za e amy Za%te4el—3y 
Bo5e3—-l THRU 3e5 63539 BeSeS—1ly Be5eGmhe BeS5almbye Je 5eG-1ly Be Sell—ly 
4oOeO- bs GeleO—-Ly Gelelrhe 4ele4n-2— 4aleS—2y 4eleol3-24 4e2-e0-ly GeleO~l1y 
SeleO-2y 6.0.0-1, 62000—-G_ GLOSS—2¢ APPeA-2 THRU APPeA-S_ APP.B-15 
EXTENDED BCD CARD COCE (SEE EBCOIC CODE} 
EXTERNAL CONSGLE FUNCTICN 
4e2e0-he APPLA 


4el.b-ly 20 320-3, 4alel-ly Be3e2-lLby 4e1e00—1lye 


EXTERNAL INTERRUPT 3e3e2~1, Bedel—2ye Be3e2-1b,y BeBe2~2ly 3e302-30, 3e3Be2-3ly 
Be de2-339 AeOeO~Le SeleG-le %e2%eO-]e 4elel-l 


EXTERNAL SYMBCL OIRECTORY 3e4el-2 7 : ’ 


F (SEE FIND RECUCST) 


FCB MACRO-INSTRUCTION ZeGele2m Sy JehMeleo2—le Beh%ela2—2y Be4%ele 2S THRU 
3e4e]).2-7,5 364-122-100, Behele2-l2y gosaele 2-13 


oF I (SCE FILL CONTROL) 
FIELE etic iy 3.106724 Bolebln-2_ Zolel2—ly Selel2—-2e Belel4-ly 3olelT—3+ 


Fa 2ad-4y Fe2eGrbe Be 3el—by Be Beb—-3y 363502-305) 34362-35355 364014 2-4% 
Ze4ale 2-7 3.40) 22-10% Za4ele2—-lT, Ba4%e 23s 3.4.4e1-24 52360-2) 523.0~5, 


FILE DESIGNATION (SEE FILE IDENTIFIER) 


FILE CIRECTORY (SEE DIRECTCRY) GLOSS 

FILE IPENTIFTIER GLCSS, 221-0-1: BeleO-by 3,41.0-2) BeLel-1, 3.Lel-2_ 3.1.3-1, 
Bel.3- 2, B.Pe.4- 2, 36124-3, Beleb-Ly Beleb—-2- Joelbeb—-4, JeL-6-5, 341.6-28% 
Bele6-29_ Bele Thy SelbeG-2y BeleG-1l THRU 341-9-3) 3elelO~24 Beleli--2y 
Belell—-4_ Belel5—be BelalS~-4_ Babel 5-5 BelbalG-2y Bele) 7-2y 3-1-1 7--3, 
3.2a1-1hy 3.2.1-2, Ze2-2-23 3.2.3-1, 2e4ele 2-3, Bebele 2-13 Buhne Bs 
Behe 2-Ge Bohe2—L)y B6%e2-137 36404—-3_ GLOSS, GLOSS—2s APPLA~]_, APP.A-3, 
APP.R-3, 6.0.0-1 

FILE MANIPULATION BabeG-2_ 361-0~-1, 3.2).6-6 

FILEMCCE 2eleO-2y AelsaO-le Belal~Ly Bebel-2y Bele3-Ls 3ele 3-2, 3612.4-1h THRU 
Ze le4—3e 3.1.6-4%, 3e1.6-13e ZeleTu-ly Zelel~2 3n1e8-1, 30169] THRU 
BeL.G-4_ Bole Li-L THRU 3.1eL1-3_ Selell-G_y BelLelLi-Ve JBelel3-ly 3elel4rds 
ZeL15—1e Zelwelom4e BeL-15~5, Bele. LI~3y Balel-ly Be2el-2y Be 24 le 
Be Qehnr2y 3020 GH 4y Behe be 24g Behe le 2-Hy Bn4eloQ-Llsy Bahebe2-loee 36% 2-8 
3e4e2-10 THRU 3.4e2-125 GLOSS~2) APPsA-Le APP.B-3 THRU APP .B-6 


FILENAME SebeO-2y AebeO-ly Beleleby Belel—2_y Seba3-ly Bebe 3-2, Sole4—l THAR 

. 3.1.4- 35 SeleG-ly 321.65-5,5 3.1-6-13; 3e1-6-14, 3e1.6-28, 3e127-1 THRU 
3e1.7-3; 3e1.8-1, Bele 8-25 3.).9-1 THRU 321.9~-4, 3e1.10-1, 3.1.t1l-1 THRU 
Belell-Ty Belel2—-le Bebel2—-2, Bobo l3-Ly BoLel3-Sy Bolola-by Belel5-ly 
Bele15-4, Zale lG—l, 3e1216-3, Ze1e17~-1 THRU Zell 5 36220-1, Zetel-iy 

24-25 Be2e3-lys 3e203-5 Be2e 3b, Ze2e4-ly 3e2e5—-lLe Bal2ebmls Ze2eT—iLe 

olm—2e 3.268~) THRU Be 204, Zae4el~-ly Be4el—2,y Be4el-Ts 3e4e1lelo-le 

Le2-4y 3.4%ele 2-8, Ze4ele2-ll, 364-162-125 Be4e2-1 THRU Bu 4e2—3 

2-Ts 3042 2-8; 32422710 THRU Se4e2—l2y 3o%e4~] THRU Ze%e4~3, 
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bdr 4 - 


BoMeholmly Be5el-ly 3650125 3a2e3-ly 3e50 3-3, 3e5el2—Ly 3e5el2-2¢ 


3e5eh3~-1ly GLOSS-2— APP.LA-1,y APP.B-3 THRU APP.B-7, APP.B-9 “y 
BeOeO-Lp 32000-2, 301.19-1, Bele l 9-2 e OS 
FILE REQUEST (EDIT ENVIR.) 3sle6-185 361.6-B8y 30166-199 34166-5 THRU 
3ele6-6y 3eleb—-36_ APPLA . 
FILE REQUEST (SCRIPT EDIT ENVIRON.) Belel3~12, 321413-34 Belel3~4y 3elel3—-6 
FILE SIZE Beled-2y BelbelO-Ly 3elelG~2s 3e203-Gy 34245-2) Ba2eT—2, GLUSS—2, 
APP. A~3 
FILETYPE 2eleO- 2 AobeCHly 2o1e0-39 360.0-]y Belel-ly 3elel—-2y 
BeLe3-Ty 32163-24) 3e1e4-k THRU 3e2e4-3, BeleG—-1y 3eleb-25 30l06-5y 
Bole6-27y 36126-30 BoleG-3l, 3e1.7-1 THRU 3.1-7-3) 30128-1y 301-8-2, 
Be169-1 THRU Bebe 9-4, Sebel O-Ly BslelO~2y 3.1610-4,) Belell-l THRU 
(BedeblnGy 3.1.1 l-6y Bolall—7y Belel2—-Le Belel2—2s Belel3—1ly Belel4-ly 
Zelelo-by 3ebel5-4y BelelG—ly BelelG-%y 3.2.17=-1 THRU 3.1.17-5_ 302001 
Bo2ednly 3e2el-25 Be2e2-1 THRU 342.2-4¢ 36203-4 THRU 34 Z03—6y 302041, 
Be2eS~ Ly BaP eS-2y Be2eTmly Ba2eTm2y Ba 2e8-]l THRU 3e208-4y Badel~2, 
Bohol Te Babel el—-3y Bate le2—4y Behe la 2—-By 30402-2) Be4e2—8 THRU 
DeMet~ Lee Behetm hy Bebehelm Ly Be%eheb—Zy Bael-ly 3.503-le 30503-3, 
BeSelb3-by Ge3eC~ly 564602, GLOSS—2 THRU GLOSS~45 APP. A-]le APP.B=<3 THRU 
APP.B-7, 3,).-19-1, 3421.419-2 
FILL CONTROL Be lel3~-30e Belel3—-7y 3e1513-34y Bel0L3-35, 341613-44, 
Bebe 3-46) 361013-47 : 
FELL MCDE 3.1213-2) 
FENO MACRO-~INSTRUCTICN 304.1.2-1 
FIND REQUEST Beleb-204 SeleO-4y 3e166-Gy 341.6-8, 323.6~13, 30106-25, 
Bele G-394 Feleb-4hy BeleG~43, BeleG-Zle APPehy Bele6-L5 
FINIS COMMAND BebeB~Ly 201.0-4, 34261-3, 3eleO-2, 361.8-2, Bo2el—2y 
De2n4n-Zy Be4ele 2-13, APPahe APP.B : 
FINTS MACRO-INSTRUCTION Babee 2-139 Be4e1 2-1 yy Behe 1a 2-2 
FIXED oe RUCORD Behs3~le Bele3-25 3eled-ly Selell-3, 3elel4-l, 3.1.215-1, 
e4elm 2s BaGeb-Ty Be4e Le 2G, 36401 02-7 y 304010 2-10) Be4ele2-]1 o4e02- 
BelelQLy 361.19~2 , : is i 
FLAG Belel4-22 3.3.0-Le 36322-30, GLOSS—3 
FLOATING POINT REGISTER CEPR) BeBeb-4y 3.302-1Ly 3e303-1Ly 3n304-1 THRU 30344-4, 
Behele2-1Be 4ebeG-L THRU 4o164-35 4oleS-by Selel3-1ly 40200-1y APP.B-16 
FLOW FILETYPE B.1L.6-1 
FURMAT COMMAKB BeSehm Ly 365092) Bel. 7-2, BebebZ-2, 3Be5el—le 3e5el-2y 
‘ 3.5.4-1, 3504-25 Sele Gl, APPA, APP.B, APP.B-5 
FORMAT CONTRGL bCROS Belek3-2 THRU Zel.13-4) 301013-6; Be1e23-7 
FORTRAN COMMAND Jo4et—Le LeOeO-3, 3e1.19-Ly3ebelG-2, 342-3-2¢ 32208-2, 
y 
a 
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32302-5y 3e322-8 304022 THRU 3042-13, APPeAy APPoB, APP.B<15 GPR RECUEST Bo3e2-3y BeBe2-24y 3n3e2~-25y APPA 
FORTRAN FILETYPE — 34206-33¢ 301-6-29; Bale6-Ly Bole6-9, 3ebo9-2 ae | ePRS OPTIGCN 34 Beha Ly BeBel-4y 3e30h-2y 30304~3r APPLB-1E 
FORTRAN IV LANGUAGE  34%e2~4- APP.A~2 GPRSA CPTION BeBe4—-ly 0301-45 363042, 30304-3e APPLB-16 
FGRTRAN IV LANGUAGE MANUAL = 32402—4) 30402-94 50120-2 GPRSU CPTLON  30304—Ly 3e3eb—-4y 36304-2 THRU 36304-5, APP.B-16 
FORTRAN IV LIBRARY SUBPRUGRAMS HARUAL Bee 2-4 : FALE. WCRD BOUNDARY Be 302-4 THRU 343¢2-63y 30362-22 
FORTRAN IV(G) PROGRAMNER'S GUIDE MANUAL 3642-4 HALT 1/0 INSTRUCTICN 3342-21 
FPR {SEE FLOATING POINT REGISTER) eHE = (SEE HEAD CONTROL) 
FPRS CPTIGN 3.3.4-Le 3e3-1-4y 303-4-2) APPLB-16 HOAD CONTROL = 3010123-3hy BeleL3-Ty Bebe l3-44— APPLA-9 
FPRSA OPTION Bede4-Ly Bndel—4_ 30 304—-2p Bede4—%4y Bede4—-5_ APPOB-LO . PERBCEG IAAL SERRES ENTE TEN BaBe2—2e 3e3e2-4e 30302-1004 36342-118 3.3.2-1by 


FPRSB CPTION Bede4-by Bedel-4_ 36364-2, APPLD-16 : 
tumMe ALORESS BeSe4-Ly 345.4-2 
FREEMAIN MACRO-INSTRUCTICN Be4ele 2-1) 
J (SEE INPGT REQUEST, INSERT REQUEST, IPL CONSOLE FUNCTICN) 
FREEPCCL MACRO-INSTRUCTICN 3e4ele2-] 
; lis (SEE INCLUDE CUNTROL SECTION CARD) 
FULL WCKD BOUNDARY Bade A-lGe Gole4dm2e GeleS-2y 401213-2 
: IDENTIFICATION CARD (CP) 3e1.11-4 
G CPERAKO OF CHANGE REQUEST 3e1.6-14 
eimM (SEE TMBEO CONTRCL) 
GEN CPERAND GF NACLI€ COMMAND BelelO-Le BabsO-Ly BalelO-2y Bele lLOr-3y Bede Bye 


APP ..B-6 IMPEL CONTROL 341413-32) 3e1e13-65 3elel3—-Tp30lel 3-24 
GEN OPERAND OF TXTLIB COMMANG  3e1eL6-1, 301eO0-1le 3ebel-2, APP.B=7 eIN (SEL INDENT CONTROL) 
GENERAL PURPOSL REGISTER (GPR) 203e0-3, Bu2el-2s : ; INCLULE CONTROL SECTICN (30S) CARD 5 0500-39) 525 eO- he Be 203-5, 50520-1 
Be2eb—Ly 3e2e6-2y Fa2eb—-2y 3e2B-3y BudeO-by Ba3eI—3y BaBel—4e Bodu2 dy 
Fe 3e2=164 FeBe2-17e Fo 3a2—2hy Bode 2-24¢ BaBar-33— Bede 2 3hy. Bee 23s INDENT CONTRCL — 344613-33y Beled3-4o Bebel3-Ty 3olel3-37 
3e3e3-1, Bede 3— Bp Bede 4-1 THRU 36364°-459 Ba%ele2-1LBy Geb e 4-1 THRU 40) 0473; . 
heleS-ly 4elel3-ly 4eleol3-29 4200-1, GLUSS—2) APPshm4y APPeA=5y APPLB-16 INDEX NUMBER = Boks 10>3y 3o)eLe~2 
CENMUD COMMAND Fe 2e0-1y Bekalo hy SeZedr2y B2.1<3y Borie, 9ea.4-2, INITIAL PROGHAM LOAD C1PL) — GebeTmLe 2e2e2—3e 20300731 3eG0 lini s 
APP.Ay APPOB Bede2—27y Bede 2 3ly BoSe4— by BeHollady 4eOeCmby SeleOr-Ly Seleb~bs 


Aelel2-ls 4e2eColy SetbsO-)L, APPA F 


CET MACRO-INSTRUCTION Sa4ale2-l 
INITIALIZING CMS (| (SEE CMS ENETLALT ZATION) 


GETMAIN MACRO-INSTRUCTIGCN Be4e1.2-1) 


INPUT Le Oe O-3y 2e0eO-Ly 2e2eOn-Ly Zo2el-lLy Ze2el-3y 2e2Qel- Ty Qe2e2— by 2e2e3-]y 
GETPOOL MACRC-INSTRUCTION  36401.2-1 203c021 THRU 20400-3¢ BeleO-Ly Bele2—by Bele3—le 640.0-15 
; 313-2) Bele4—2y BaleO-] THRU 341.6-8) 3ele6-151 BeleG-17s 3.1.6-184 
GLOBAL COMMAND — 342.0-2y 34202—Ly 263022) 3a2e2—24 3202-35 3e4e1—3y APPA 3.1.6-23¢ Bole 6-27 THRU 3-1e6-3ly SeLolO~2 THRU SelelO-4y Seletl=d THRU 
APP.B : BeLell-3y Belell-6: 3e3ed—Ly BeBe4-3e Bebele2—44 BaGela2—Sy Beh%eba2—Te 
3.4 122-165 342-8 a i coke) Bedtahr2y BeSbahkeln2y 3452-1 345e7T~ly 
GU OPTION 34422~1Ly 304022 THRU 3040249 30402-7y APPOB-15 4.1.0-Ly GLUSS-24 GLUSS-4) APP.A-3y APP.B~1 
GO REQUEST 3ede2-Ly Bede2-3y BeBe2—Sy Bede2—by Bade2—2L THRU INPUT CHARACTER 3e)e6-Ty BeleG-10— 441-6720, 3.1.6-30 


30 3e2-232 34302-3359 APPA 
INPUT ENVIRONMENT Qu BaO-hy 203e0-34 BelbeGrhy BeboG6—-3> THRU 3e1l-6-7 Bele b-Is 


GPR (SEE GENERAL PURPOSE REGISTER) 
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Bele 6-22 3.1.26-23, 5a Leh-39, 30126~34- THRU 3ele6-3h, 3.1.13-4 


INPUT FILE BeleB-Le Bob. 3-25 BoleG-S5e BelelO—-4y Belolbl—-le Belel3-ls 3elel3-4e 
3e4al-2s Zeeelatn~4s 3e4e2-24 Bahe2~3e Behe 28, 3e4e4-1-1 


(INPUTL) FILENAME 3.1.13-4 
(INPUT2) FILENAME Jeleol3-4 


a ack bag 1.671 

INPUT LINE GLOSS» 2e2el—le 2e2el-45 2e2el-by 2e2e3—-1y Boleo3—le 36 
THRU 3006-8, Bebo G-15 9 BelaO—-17y BaleG-1By Belsb—-24_ 361.6-24%) 3461-66-27 
THRU 3obe6-3l_ BeleLI-ly Belel3—-2y Be2eBr ly 2edeP—2y Behel~2_y Be4ele2~lby 
4eleO-)y 4ebe4-2y 401.5-24 GLOSS-1 THRU GLOSS-3, 223.0-ly 22320-2y 
3.0.0-1, 460.0-l, 3.020-2 


- - - 3e4.2-8y 
INPUT/CUTPUT CI/03 beOn0-25 2020e0-Ly Bele 2-ly 3ele6-5y 3.1,15-4, 
3.4e2-)1, Be4.2-12, Behe 4-3, Bu4e4ealr-ly 3.5-8-1l, 4.0.0-1l, Gele2-ly 
4.1.3-1¢ 4eleT-le Geleall-ls 4Selel2-ly 4¢2¢0-1» GLOSS—1L» GLOSS-3, APP.A—1, 


INPUT/CUTPUT DEVICE BeBe2—-Lhy 3504-2, 34508) 
PR = a 7 L1.7-2, Beleli~-6; 
INPUT/CUTPUT ERROR (1/0 ERROR) Bele3-23 Baleod--3y JoleS—le 3. ’ 
3.1L.2L1-T7, B.1-12-?7, 3.1.213-5, 3e4nl~2 4 Ba4n1l-4e Be4el~-7 Behe 24, 
3.44.1 -2 3.1181, 3e1-13--6, 4n2e0-Ls 5210-1 


INPUT REQLEST € EDIT ENVIR.) BeleG-224 Bebeb-B, BeleG~-4- JBeleb-by 34166-23, 
3e1.6-36, APPA . 


INPUT REQUEST (SCRIPT EDIT ENVIR.) 3e1.13-13, 3.10 19=25 Belal3-3y meee 
VRPUT STREAM {SEC CARD STREAK) 

INSERT RECULST (EDIT ENVIR.) Be Le6-234 Balab—-24, 3ole6-By BebeG-39, APPLA 
INSERT RECUEST (SCRIPT EDIT ENVIR) 3.1.13-14, 321.13-7 


INSTRUCTICN LENGTH 3243-22-31 


: ; ~ ae 2-57 3.3.2-16, 
INTERRUPT LeOeO-2— 2e 300-3, Za3ee—1Ly 3630229 3a “99 3 : 
Bede2-215 3030 2-22, 34302-30, 34362-3)e 36322-3353 34342-34, aie ta 
32 545—]s 325.6-l, 3.5e7-1, 345.8-1+ 4o1.6-1, 4ele12-1) 4e2eO-lys APP AAwS,e 


INTERRUPT CODE 4.1.13-3 
1/G (SEE INPUT/OUTPUT) 

1/0 ERROR {SEE INPLT/GUTPUT ERROR) 

1/C INTERRUPTICN  3.3.2-11 

1/O OPERATION  3.3-¢2-Ll: 343-2-31 

IPL COMMAND = -3.5.24-1_ 325.9-1, APP.A-2y APP.B-5 


7 _ ~ o5e13-2, 345.9-1, 
PL CCNSOLE FUNCTION 4 eho ?-Ly 26202-3) 203.0-39 305-4-1y 325 
BeGel4—Ly 4.0.0-by 4ebeO-ds Selel-he GeleG-bhy Selel—1e 4e200-1, Sel.O-]y 


640.0-1 


t : oe te 


b14 , ee 6-168” “fy ig - 


IPL REQUEST 3e3et~2by Bede 2—hy 3e322-3, 2e Fe 2-12, Be3de2-22y 3032-33, 325.9-] 

JOB CCNYROL LANGUAGE 3042-4 

JUSTIFICATION Belelb3-1l6e 301.13-19, Belwl3-2)L, 3el.13~-22, 3.3.2-3, 3e302-12, 
3030234, 30 342-38, 4Sele2-ly, 4.1.13~-2, 4e1213~3, 50 3e0-2, 5030-4, §.23.0-5 
Belel3—26y 3elel3~30_ 301.13~35, 3-1.13-46 

K-LEVEL COMMAND (SEC KE, KCy KT, KX) 2e2e3-ly 2030-2 

KE COMHAND Zelel2-1, 3.3.2-), 3.5.5-1, APPA, APPeA-3, APP.B 

KEEP REQUEST © 3e1613-15) 301.13~7 

KO COMKAND 3o3.0-1L, 3.3.1-1, 3.3.2—1, Bede B-1Le 303.43, 34526-]y APP.As APP.B 

KT COMMAND Belel2—l, 32e3e2-ly 3-5n7~1, APPsAy APP.B 

KX COMMAND 3e4el~4, 3e5.8-2, 6.0.0-1, 6.0.0-5, APP.LA, APP.B 

KX REQUEST BeBe 2-hy Ba Be2-3y 30362~22, Bede 227y APPA 

L {SEE LOCATE REQUEST, LOGCUT CGNSOLE FUNCTION) 

LABEL 3.1.14-1l, 3.1.14-2, 3el.17~—l,y Be4els 2-1, Beha le2-4 THRU ZBeAsnle2-7T,y 
Be4ele 2-9, Be4elbe 2-10, 3Be4el1l.2-12 THRU Ba4ele2~-14, 3.401.2-16, Be4ela 217, 
36404 3s Be4e4el—-1 THRU 3645401-3 

LDOISK OPTION — Behe dm ly Bed4el-29 36401-3 

LET ACJUSTMENT Be3e2-3_ 3322-12, 343.2-34, 36322-38 

LENGTH ATYRIBUTE Bads2-1L2_ 30302—-14_ 30302-42_ 34302~43 

LPBE OPTIGN Be 23-25 34263-4 THRU Be2e3-Gy APPLB-15 

LIBNANE BelelO~-) THRU 301.10-4, 3461.16-1 THRU BebelO-3y Be2e2—-Le 3202-2, 
3.2.3-1, 3Be2e3-2y 3e2e 3-4 THRU Feta anmbhy 3e2e5-l, ae2e7—-), 5420-1, 
Se%e0-22 APP.LB-5S THRU APP. B~7 ; : 

LEQRARY FILE. BelsO~2, 3462.2-1 THRU 3.2.2-3, 5% eO-l1y GLCOSS-4,. APPLA-4, APP. G-3 

LINE-DELETE SYMBOL (#) GLOSS, 2.2.3-1) 3,1013-2) 3.10134, 

Be be2—2y Behe le2Lby Be4eba2-1Ty 3e4e4el-2y 365.2-1, 3.5.5-1, 2e5.6-1, 
De deTm~Lhe 245e8-be 4eleO-ly 6.0.0~-4 

LINE FEED KEY 2e201~6 

LINE IDENTIFIER Baleb-2y 3106-15, 3.1.6-20, 3e2e6~25, 30146-28) 301.6-3] 

LINE LENGTH Belel3-16, 3e1213-17, 361213-19 THRU 3.1.13-21, APP.A-9 

LINE LENGTH CONTROL 3012-13-34, 3elel3~7y 301013-44, 341.13~46 


LINE NUMBER Bele le-he 341.22-2) APPLH-3, APP.B-10 


Poo 


See 
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CTRENO OPCRAKD 321.6--30 


LINK HACRO-INSTRUCTION Behele2-1 


LINKAGE GLOSS, 3.2.0-1ls 3026 
BeAeTH 2, Be4e) el -3e 3646 
BeGele2-L3y SeAreO~ly APP 


? Be Par Sy Be2es~hy Bote blk, Bete m2y Be2eT~l;s 
~“Ne Sehels2—ly Satoke2—-Tye Be4ele2—-liy 
‘ 3+ APP AWS 


LIST OPERAND OF NACLIB COHHNARD BeL-1O-Ly 32e100-2, 3e1-10-3, 3.1.10-5, 
Zelel2-2, Zehtel 3, APP.B-6 , 


LIST OPCRAND OF TXTLIB CONKAND BelelG=Le BeleO-2y 3.1.3G--2 THRU Zoledn-Sy 
APP .LB-7 3 


ETSY OPTION Bo Be2-Sy 36362-8, Bohed-Ve BeGe2—Le Betel-22 Boehe2—3_ APPLD-1LS 


CISTE COMMAND 3.0.C-], 3-).0-2, BaolebhrGy Be1l.8-2 THRU Babe Gey ZelelS--23 
302-8-4y Be5al- ey 3.503-1y Bede 3 Be BoSelLO-]e Bee 1O-2¢ GeO 0-1, APPohs 


APPLB 
. a 
LISTING FILETYPE Bels18-1ls 3e1-19-1 
LITERAL Be%eGol-) TAU Be%eh%e1-3 
elk (SEC LIKE LENGTH CONTROL) 
LOAD CCHAAKD Bete Orde Be te3~)_ 2a BeI—- By BeOO- Ls Fe2eO- Py 5 


BeZeledy 322021) THRU 3. 202-3¢ Be2e3-2 THRU 2e2eB-Gy Be2edr dy 3e225-2, 
Be2etm hy 32207 Py Be2eB~) THRU 30208-Ge Bedet iy Behol-2y Sehelal- ds 
Sede Ly SeheO- 21 GeOeO-Le APPohy APPeAH15_ APPLO : 


LOAD NAP GLOSS, 36203-2222 3e2e3-1, 34263-3 VHRU 30203-7s Bo 2smdy Baden 2y 


BePe.t-2s Se 3.0-} ' APP.B~-15 


L040 CPERAND OF DISK COMMAND BeloU~Ly 3ele4—-1 THRU 2ebe 4-3, APP2B-4 

LCAD GCPLRAND OF TAPE COMMAND BelelS-]y 3e1.0-1L5 Bele 15-2 THRU 3.16 1%-5, 
3ele19-1, APPAR 7 

LOAD POINT BelelS—21 Bede l5—-35 Be Aud 2%y Be 2aG—bhy Bade 2209 Baele lh 


LGADER OPERAND OF GLOBAL CORMAND Be2e2-1ly 2e2e 2-24 Be2e2-3y Je 203-2 THRU 
3e2.3-5y 9400-2, APP .U-5 


LOADING 327.0-1; 3.7.0-2¢ 3Be2el-le Ba 
Be 2e3B-2e Be 203°% THRU 322035-Ge 3 
Betebm by 262062, Be2eTm~Ly 3620 7- 
343.2~-231 Zerhial-2y Behe le l~ty 344 ° Bean 3y Be Gena, Be 4e4el- By 
Be Ged 3 BeGe lm ly 4eO0O-L sy Seba tm] eO- ly Se%eO-Lky 5e300-4%, 523.0~5,y 

Ge0.0-1y GLOSS~2— GLOSS~3_ APPeAW-2 THRU APP ASS) APP EBHALS 


20) THRU 4L2.2-3, 32202 De 
ona Ze 2e 5) Bee G- ey 
THRU Be2eO—-45 3036 2-21 THRU: 


Pe NNN 


LOAUMCD COMMAND Be2edmLy 30OeO0-1y 3.2.0-1, Je 500-3 3.27ud—), 
Betehnm2e 3B.2e8—1y 3sulel~3d, ba2eb-Ge APPaly APP LB, APP. 0-6 


LGCATE RECUEST CEDIT ERVIRS) 3216-25, Jelab—4y Seb.6-By 321.6-137 361.6715, 
SeleG-Lb, 3166-20, Do beb-26— Bolbebr-4le Sebeb6—-43, Be5e149-2¢ APPLA 





- LOGICAL BACKSPACE CHARACTER (53 36 
t 


bol 6-1-68 


20 - 
bsy 
LOCATE REQUEST (SCRIPT EDI ENVIR.) acVs-¥6;, Belel3~7 
LOGGING tN Zalod—le 1-0.0-2, 260.0-1, 2e2e0~ks Za2el-3y Zeo2ol~-bs Zatel-Ts a 


2e2e 2-24 Zale 3y Belell-2s BebSel-ls Bebe tnmly 4.0.0-1s Geleloly 
4el.10-ly 4alwalO-?y, 4a Orly 5.1.0-1, &.0.0~14 b6.060-2 GLOSS—%y_ APP.B-3 


LOGGING OUT 20202-1 THRU 20242-3) Bele2—ly 3e2e2—-24 Be2e 2-3, 3e3eO—1ly Be3el—hy 
BeBeB— Le Zodeh-By BorreGe ly Ze5ahl—-ly Sela2=2¢ 4eleOle Ge2eO-]y 5aGeO~]y 
Bote Oe 2— 3Be5el Ul, 3n5e10~24 GeOeO-Ly GLOSS<4_9 APP.A-3_y APPLA-5y 

Ly BeleG~3 THRU 30106-5) 3e106-97 
Beleb-1dy 3ebeb-25,y 361.6-28 26-29, 301.6~-33 
LOGICAL ShITCH  3.5.3~2 


LOGICAL TAB CHARACTER ¢!*) Bele 6-2 THRU 3el.6-5y BoleO—-Ty BeleG-lLly Beleb-15, 
3e1-6-20, Zaleb-23 Sele O25, Bol 6-284 Bele6~33, Bele b-35 APP.A~T 


LOGICAL TAB SETTINGS Bel. G-2, 3e1466-5 THRU 36166-84 36166-2114 361 06-245 


301-667-295 Bele 6-39 


LCGEN CUNMAND Bebe Le Faded ly BeSel—2y Bob e4— Ly 3089 2e 3650132, Sele O~ly 
SebeO-25 APPehy APPeA—-3, APP.B 


LOGOUT CONSULE FUNCTION  26202-39 3-5e10-Ly SeleO-Ly 4eleO-ly APPoAy APPOB 
LOGOUT COMMAND 3.5.10-Lby 3e5e8-1Ly 3e5s10-25 3e5ebl~ly APPeAs APPOB 

LPRINT OPTION  3.24e.-1 THRU 3.4.13 . 

UPSh INSTRUCTICN 

LIAPN CPERAND — 364e1-1 THRU 304%el~4¢ 361618-1¢ 3elel9-1 

h (SEE NSG CONSOLE FUNCTION) 
VACHING CRKECK = 343.2-30 
MACHINE LANGUAGE CODE 241.0-3, 3-4.1-1, 34-2 Be4e2—le 34422-2 


MACLIB COKMAND ZelelO- THRU BeleLO~-Gp 3e10619-Le BolelI—-25 Ze%el-35 5a 400-1 
APPA, APP.B 


MACRO 3.1e10-1 THRU 321210-6, Belel2-2, 3eLeL2-35 34260-2% 34262-1 THRU 
Bato 2-3 Bu4el—3y Zaobalaelrty Ze4ele2~l THRU Saale l-Te BeSele2~-F,y 
BeMele 2-10, Foe4ele2-12 THRU 3.44.1.2-20 


MACRO DEFINITION Bele LO-L THRU 3.14610-4, 3-be LO-Gs Bebe l2-25 3e1-12-3, 
3.2-0-2) 3.222-1 TRRU Be2u2—3 Be4el—-35 3e4ele2—le 5.4.0~-1, GLOSS-3 


MACRO CEFINITION FILE 3elel0-2, 341.10-3 


PACRO LIBRARY GLOSS» ZebelC~rl, 3.120-1, 321.0-2, 3e1210-2 THRU ZelelO-4, 


Be4eln-3,y Sehtelatmly 5040-15 APPLA—-29 APP eAn-3 


MACRO NAME 3.1.10-4 . 





6-1-68 


65.2 2- 


MAIN PROGRAM = 302e6-Le 344023 


HAIN STORAGE (SEE CORE STORAGE} 
MAP FILE 3elel6-1y 325.13-3 


MAP OPTION 3e2e3—by 30402-1y 36203-2 THRU 32203-59 Behe 2-39 3e4e2—~4y APP.B=15 


MAPPRT COMMAND 345613-1 THRU 3.5-13-3, APP.A-3_ APP.B~6 
MARGIN STOPS 242.1-3, 20201-7 

MASK (SEE PROGRAM MASK, SYSTEM MASK) 

MEMO FILETYPE 321e6-2y 3e1e6-2y 3ele6-6y Bolo6-Ty 3a1e6-155 30166-37¢ 30106-43 
PEMORY = (SEE CORE STORAGE) | 
MEMORY RELOCATION HARDWARE = 1.0.0-1- 
YEND CARD 3e1.10-4 
MODULE FILETYPE 342.41) 32201-1y 342-1-2 
MSG CCNSOLE FUNCTION 4+1.9-1y 4eleO-Ly APPOA 
N (SEE NEXT REQUEST) 

N OPERAND OF MAPPRY COMMAND  3,5413-1y 365+13-2 
NESTING — 344e4-4) 36543-2 

KEXT AVAILABLE LOAD LOCATIGN  3e2sl-1y 3.201-25 34204-1y APP.B~3, APP.B-5 
NEXT FREE LOAD LOCATION (SEE NEXT AVAILABLE LCAD LCCATICNI 
NEXT REQUEST (EDIT ENVIR.) — 3Bele6-27y Bebe6—22y Bele6—By 3e4ele2-17y APP oA 
NEXT REQUEST (SCRIPT EDET ENVIR.)  3eLeb3-17y 3ele13-7 
«NF (SEE NG FILL CONTROL) | 
NO GPERANC CF MAPPRY COMMAND  3.5.13-1 
ENC) CPERAND — 341.6-365 341.6737 3e1e6-5y 3026-7 
ROCLEAR OPTICN 302.3-Le APP.B~15 
NCCECK OPTIUN — “3.4e1- 1, 3e422-Ly 3e6e1-2) 3e4e2-3y APPLO-15 
NOCIAG OPTIUN — 344e1=2y Be4a2—Ly Be4el-2y Beha2—2y Behe2—hy APP.D=25 


KO FILL CONTRCL 3Bo1.13-35— Sebo} 3-7y 361613-30, 361413-34, 301213-44 


. 
‘ 


KO FILL MCDE 3.1-13~-21 


NOGG CPTICN Be4o2—-ly 3a%e2-22 APP.B-15 


- NL .ST OPTION 


 NOPRINT OPTION 


“NO UFD OPERAND 


 NOWALT OPTION OF SETCVER COMMAND 


’ CFF QPERAND GF PAGE NUMBER CONTROL 
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22 - 


Betel-ly Behe2—Le Bahal~2y 304e2—2 THRU 4402-45 Bohodmly 
Zahn 4y APPLB-LS . 


NOMAP CPTION Botedmle Bohe2—Le Be2e3-2y 3e%e2—2, §.4.2= 35 ApP.8-15 
NOPARM OPTEON Be da4- 29 36304-3 THRU 30 364-5y APP.B-16 . 
Dotetle Be4e2—29 364e2—-35 APP.B-15 

NORENYT OPTION Be4el~ls 304el-29 APP.B-15 


NORMAL OVERRIDE 3.3.0-1, 3.3el-l, Badel-3, BeBe l--Ay 34303-3, 32304-2 THRU 
30 3e4-4_ APPLA-4 


NOSOURCE OPTION  36402-Ly 30402-3 APP.B-15 
NOTE MACRC-INSTRUCTICN  30401e2-1 
NOTYPE OPTION  34203-ly 30203-5_ APP.B-15 
3B65.9-1ly 345.9-2 
KOWALT OPTION OF SCRIPT COMMAND 361013-1, 3e1013-3 THRU 3.2.13-5 
3.3042, APP.B-L6 

NOXEG CPTION 34243-2) 30203-4) 30203-5y APPABH15 
NL EF OPTION  3e4e1-1le 3641-2, APP.O-15 
NUCLEUS {SEE CMS NUCLEUS) 

NULL LINE GLOSS, 34146-3 THRU 30106-7y BeleG—-12y 3ele6—-30, 3ehe6-36) Bele6-41y 


30.1213-2, Belel3-4, 3.1.13-8, Zalel3-ll, 3.1.13-13, 4e.1.0-L, 6.0.0- 2, 
APP eA-Ty API CA-8 ; ; , 


_C (SEE GVERLAY REQUEST} 


CBJECT CONE (SEE RELOCATABLE OBJECT CODE, MACHINE LANGUAGE CODE) 


CHJECT PROGRAM Be4oleby Bahe2—Ay Bahn 2-7 
oQF (SEE OFFSET CONTROL) 

CFF OPERAND CF HAPPRI COMMAND BoSelB-Ly 325.13-2 
3ele13-39 


CFFLINE COMMAND Belabl-Ly 20302~24 Belo2—-le Belell~-2 THRU B.1.1L1-7, 3.4.1.2—-1e 
3e5e13-1e 6.0.0-Ls APPLAs APP.B 


CFFLINE DEVICE GLOSS, Behe le2—bhy 365eB8-1_ 62020-Ly APPA} 
CFFLINE OPTION. OF SCRIPT. COMMAND Jee l3-) . ' 


CFF' INE OPTION OF SNOBOL COMMAND Be4e4~l 


tard 


6-1-68 OSY 
2: 
CFFLINE PRINTER 3.1.0-2, 3e1-9-2¢ Bele Ll-3, 3.3.0~-1, Be3el—ls Zedel~2s 
‘ Zedal—4y Be 3de2-L5, 30302-1T 30342-1184 Ba de2-20y Za3e3-1y 3-324-3 THRU 
330 4- be Be4al-lLy Bet&el—3,e Bete2—-l THRU Datal—4e 3e4a%-le 3e526-1, 
* B.5.23-Ly 325613-2, GLOSS-4, APP.A-3_y APPLA-S5 APP-A-10, APP.B-1L5, 
3.1.6-3, Z.leL3-ls 3.1-13-3, 361.18-l, 3e1519-~1 
CFFNG CPCRAND OF PAGE NUMGSER CONTROL. 3.1.13-39 
CFFSET CONTROL Belel3- 365 Belel3—4_ 3e1613-74 301013-33 
CN OPERANC OF PAGE NUMBER CONTROL 301.13-39 
CNLINE GLOSS» 1.0.0-2, 3a2e5-1¢ Bese2~ly 303-2715, Be4el—-ly Be%Mel-5, APP.A~1 
CNLINE OUMP 3032-17 
CNLINE OPERAND Bede2-15_ Be3e2-17 THRUS3I234 2-19 
GRLEINE OPTION 364%04-1)e 3e4e4-3 Jebel 4 
CPENING FILES 20160-4¢ Belell—by 3201-29 Be2el—32 30204—-24 34362-271 


Be4ele2-8y 3.461-2-11y Behela2-1L3_ Beho4el—2y 365<8-1le GLOSS-1 
“GLPEN KACRO-INSTRUCTION 3e4e1-2~1 


GLOSS, LeOeO- 24 3e0.O- Ls 36060-2p BeleGr1le BeleG-Gy 3o169- by Zele Pe 


CPERANEL 
BelLwlLa-le Baba l4~-2e ZelelT-2s Belel 9-2, Betad Gy Be2e4-le Bal2abm-ly 
3.2.81 Zedel-le 3.322-2 THRU Ba Bdal—by 3342-10 THRU Ze3e 2-13, 3e2322-15 
THRU 3o3e2-17y Bede2-2le Bede 2-224 Badal 24_ Be302-26 THRU 30322-294 
3302-31 THRU 363.2-35 9 36 302-30y 3032 2-39, Fe Fe 2—4h2_ 3430 3-3e Behe lel hy 
Behe lo2-4s Be4ele 2-52 Za4ele 2G Beebe 2-104 Be4ele2-L3y Be4eLe2-1Ty 


BeGeGal-le BaGehale2y 3e5e4m2e BeSeG— Le 30569-25 3e5eLO~Ly 4e1.O-]s 
Aelel3—ly 6.0eC-1, GLOSS-2 THRU GLOSS—4_, APP.A~3 ; 
3503-1 THRU 36523-3 


NPERAND SUBSTITUTION 3.2.8-1,) 


CPERATING SYSTEM {SEE 08/360) 


CPERATION CODE 3e302-5y 36302-22 

Ze 2e5-1ly 3e2-5~-2¢ 
3e4el-le 
2502-1 
Bele 18-1) 


APP.D-17 


3e203-4 THRU 322.3-6% 
303e4-1 THRU 34364-7¢ 

Zehetrly Betas 
helal3~2y Sa deO- le 
APP.B-6, APPsB-lbe 


SPTION 301.9-2, 
Be2eT—ly Be2el—2s 
Be4elnm2y Bo4el-Sy 
365041, ZeSell-l, 
Bele lO-ds &,0.0-Le 
THRU APP.B-19 


Ze2et—lhye 3e2. 3—2, 

32268-4, 3.3e1-ls 

3Be4e2-1 THRU Bahte2—“y 
3e5eL1-2y 3e5e1L3—1le 
APP.By APP.D-3, APP.B—4y 


CRIGIN Jode2-by Bede2—-Te Be 3e2-12 THRU Bn 30e2-109 34302-21 THRU 343.2-231 
Bede2— 282 3e 302-325 Be da2—-38 THRU 36302-40_ Be be2-420 343542-43 
CRIGIN RECUEST 3a de2—-3, 3302-4 3e3e2-6% 32 3de2~)2 Bede2—-L3re 
3a 3e2~1Lbe 3032-174 3e3e2-21y 3e3e2-229 3a 302-26, 3.302-29) Be d02-39% 
30302-4245 36302-4354 APPLA 


63s 


Y - 
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CS$/360 LeOeO-Lye L.0,0-24 Botello Fohelb-Sy BeGale2—Ly Behele2—Zy BeGeZ—3y 
Be4ed 4, 40020-1, GLOSS 2, GLOSS-5, APPLA—1 

CS HACRO- INSTRUCTIONS 364eh.2-1) 

CS SVC 343e1-3_ 364.3-39 36 404—4 

CuTPUT GLUSS: 24 2e0-by 2e2eI-3e 2a2eb—by 2e203—-1Ly 2030 0—2y 
3-1.0-25°3-162—1s Bole 3-Ly 3obs3-2¢ 34164—-3_ 321.10-2, 3451.210-5, 3.1610-6, 
Bohkeodl-25' SeLeli-3- Belobl—-be Zelell-&y Jalol2—-25 3ebel3—-35 Belel3—4y 
JBolol3~L5s Bele)3-10 THRU Bole13-3ls BelelG-Ly Belel4—-29 3ele25-3 THRU 
Belelo~5e 342.0-1, Bete 2. BeBel—l THRU 3.3501-45 3e302-Gy Bede2—Dy 
3o3ee~15 THRU 3032-204 BeBe2-224 30302724 THRU 34322-27, 34302-2959, 
36342-3) THRU 3.322-33, Ze Be2—3hy 3e3e 2-37 Bede2-394 Bede 2~4ly Bede 2-43, 
30 302-44 _ Fe903-2y Be 303-39 363644 THRU 3304-7, 30401-2 THRU 304el—4y 
324elee~3y BaGele2—'iyg Behe le 2~-1l4, Bede 2-ee Bete2~34 Bu hto2-De 30404-2 
THRU Behan, 3.5213-3, 4.1.0-1, Sele2-Ly &ele2—-2s 4ale4-3, 415-2, 
4.1.8-1, GLGSS-4, APP.A-10 

Curpur FILE Bele3-ly Sale3-2y Belell—-3s Selall—6s 36)013-20, 3440102~3, 
Zee le2—“y Be4e2—2s 30 402-8 ; 

« 

CUTPUT LINE SeleL3-18y 3.) 013-19_ 3.2013-215 Bele l3~-225 3e5e5-] 

CVERLAY BeteS- Ly Ba2eTHly Bu 20 7TH 2y 3a 2eBr2y Be 2eG- Oy 364 6401-3 

CVERLAY REQUEST Be leG-28y Bebe G-29_ BeleGely BeleG-By Bele6—-135 Be leb—321 
Ba leb-39—¢ 30166~43_ APPLA 

CVEFRRICE GLOSS, 343.0-l,y 3.3.1~1l, Bedel-3, 3e3n1-4, 30302-3925 3436 3-31 
Bede PF THRU Be be4-My Behe l-3y Boe le2—Ty BeSaG—ly APPaA—Ly APPLA-3 


P OPERAND OF 


(SEE PRINT REQUEST) 


FORMAT COMMAND 3.5041, 35a?» 32.521-1, 3e5.1-2, 36509-2, 


5e1-0-1, APP.B-5 

P CPTICN BaSell-le 3.5211-2 

ePA {SEE PAGE CONTROL) 

PACE NUBBER CONTROL 3212-13-39, 3.1.13~-7 

PAGE (CUTPUT) Bele li~2e Bal-11-4G_ Bedell-5,y Belel3-}e Bebe l3-3y 3e1613-15, 
Bobs V3~-L9y Belel3-2C, 3.1613-23 THRU 3.1.13-25, 301.13-27) 3o1e13-26, 
ZeboL3-3hy 3eLeL3-37, 3.1213-38, 322613-434 3040401 —2 

PAGE (STORAGE) 1.0.0-ly 120.0-2 

PAGE CCNTROL (4PA) Zelel3-7y Belel3-3hy 361.13-375 301.13-445 APP.A-9 

PAGE KEADING Belehl-2e Belsll-4_ 3e1.43-235 341-413-255 3e1213-27) 3e1013~3]y 
3.1.13-37, 3612}3-43 $ 

PAGE LENGTH CONTROL (.PL} 34L213-38, 321613-7_ APP.A-9 





U st 
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PaGt NUMBER Ietedl-2 Bebe bl—4_ Belel3-20, Jel. b3—-23— Balbo b3-27_ Brbal3-3le 
. Beleh3-37, 342.13-39, 341.13-43 © : , 
PAGFXXX OPTICN OF SCRIPT COMPAND 3ebe13-2 


PACING AREA GLOSS 


PARAPETER (SEE GPERAND) 
PARAMETER LTS? GLOSS, 36361-4, 36303—Ly 36364-2 THRU 3304-4, Je4elet-L THRU 
DeGeledbm4s Bedadet—be BeGele2—-2t Bote beP—4y BeMade2—-12y Be4eke2-Lhy 


3.401.2-16, GLOSS~4, APPLB-16 
PARML CPTION = 3.3.4-25 36304-35 3234-4) 30304-6, APPOB—-16 


PARM LIST (SFE PARARETER LIST) 


PASSWORD 2020.2-1, 20 202-2) 202023 


CERMANENT AISK GLOSS. 261.0-15 201-0~-4, 321,0-)¢ 
Babe3-2y BolsArle BaleS-ly 361-5-25 Belebrly 
“Bele T—ly 3Bele8~le Je1-8-2, Jobs G-l THRU Bel. 
Belell—-4Sy Selel2-Le Belel4-Le Bulol4-2e 3eleol5-l, #15-3, Balelb~2, 

Ze le lO~4y 3e2eCr-ls 3nlel~\s ZePulrm2e Ze2e2—-ly Qe 2s BePeAr2ye care Cena) 
Bele Br by Fe 208-3 F450 2-27Te BeGelel THRU 3e401-5¢ Be4e1-7_ Bedale 2—le 
BaGebe2-Gy BeAelalr les BaGele 2-13, Bebe 2-3By Behe 2—Hy Behe 2—-1) THRU 
3.4.2-13, 325-6 Y-l, Beda l~2e 2D Ly 305042, aeFeLL—Ls 3.5.11-2, 
Be5e13-14 4&.22.0-1, 5.1.0-1, Sele O-2, 524-0-1, 6.0.07l? Bal ab-3hy 
BeLed3-12, 3.1.135- 15, GLOSS~2, GLOSS-4, GLOSS-5, APP.A~1 THRU APP. A-4y 
APPLA-Gy APPLA~B 


0-2 
6-4 
3a1 


t Belel=-de Bela3-], 
c) Dela l--Se Bebe fm 1B, 
elell-1l, 3.1.b1-2, 
Ze) 
2 


S-B.PPA 


PERMANENT FILE DIRECTORY BeleTrhy BeleG-by Bo te4—-Le Ba2QeBr-le 34208-3y 3.2.8~-4, 
Ba4ale2—Se Fe4ele2-Gy BeSel—Ly APPLA-3 THRU APPLA-5, 34.0.0-1l_y 36126-18 


PHYSICAL TAB SETTING  3ele13-4, 3016-8 

PINV OPTICN  322.3-1) 30263-5, APP.B-15 

-PL «(SEE PAGE LENGTH CONTRCLI 

PLT COMMAND © 34403-1 THRU 3.423-4 

PLI FILETYPE | 3.4.3-1,) 3a156-2 

-PN (SEE PAGE NUMBER CONTROL) 

POINT MACRU-INSTRUCTICN  324e122-1 

POINTER Be laS-Ly Beleb—-4y BeleO-5, BelbeO-7s BeleO-10y Babeb-12, 3ele6-14 THRU 
Seleb-bbe 341466-205 Bebe 6-225 3al0e6-259 Beleb—-27T, 3006-30, Be 166-33, 
BeL.6-3by BeLeb-ATe Bed eb—Aly Bebo6-42y Balel3-2 THRO 3.1. 13-4, 3elel3—6 
THRU Beleb3-1L9) Bele 13-224 Belel3-23) 3e2el—ly BaBe2—Lhe Bata2—-2y BoSahmly 
APP.A-& THRU APPLA-8 


PREP CPTIOEN 3.2.3-Ls 34263-5, APP.LU-15 


6-1-68 a 
PRINCTPLES OF OPERATION MANUAL  34301-3, 3,3e2-10_ 303e2-Lly 30 302-3)e 32401-5 
PRINT COMMAND 3.1.13+5 ; ‘ 
PKINY INHIBIT FEATURE 2.2.2-2 


PRINT CPERAND OF OFFLINE COMMAND Joheli-ly 321.0-2;5 3ehekl-2 THRU Bole ll-As 
2 Belell-6y APP.B-6 : p 


Belel3-30e 341613-31, APP. B-6 


PRINT CPLRAND OF TXTLIB COMMAND BololG~Ly JobeQ-ly 3elelG-2 THRU 3.1.16-4, 
APP.B-7 


PRINT CPTION 


Beh4olmly Boha2—Ly Bohol—2y Be4al—3_ 3ehs2-3p Baha2—10y Be%e4—ly 
APP.B-15) 


PRINTCO OPERANC CF OFFLINE COMMAND Belwelbl-by 3.1.0-2, Bale Fees Balebl~-3, 
Belo Ll-S-p Belall—-G@y 364e2-3, APPLO~6 

PREINE REQUEST (CECT ENVIR,) 36146-3009 Beleb—-4_ 321.6-68_y APPLA 

FeINE REQUEST (SCRIPT EDIT ENVIR.) Balel3-1By 3ele13-7 

7 2 atER QPERANG CF CLOSTOQ COMMAND Bele2-ley APP.LBH4 


Pe TNIt COMMAND Zebele-by GeOeO-)y Bele O-2y 3ebe9-2) 361410-3, 3a1,10-6, 
Bebe le-2_ BeLe12—-3_ Be4e2—-3y Bae 3-3e APPeAy APP.By 325,13-3 

Pept. Bebe DA, 3elelO-5, BolbsalO-by Belelln-4e 3.1.12-3, 3ot.13-28 THRU 
1.13-31, 3.1.-16-5, Zede2-3e 3.3,.1-1 THRU 34301-4) 3.3.2-f, 3036.2~-9, 
Be2- 15 Bede 2-19, Be de2—26y Bede 2-255 Bede 2-H Bude2-4])y 30 302-44, 
303-2 30303-3% 3.344-4 THRU Ze Bnt~By Be4el—-by 36 503-5y 3.5. 3-6 
5e6-Le 2.5e13-1Ls 3.5.13--3, helw2-ly 4e1.4-3» 4.1.5-3, 4e1213-25 

1.1 : 


PROBLEM STATE 1.0,0-2, 3.3.2-31 


FRCCEEC LIGHT 2e2olm4y 2020175 
PRCGRAM ENVIRGNMENT 2e320-le 26320-3 
PROGRAM ERROR 1.0.0-2 


PRGGRAM INTERKUPT '3a302@-]y 34302-29 Bu 3e2—-59 Be3n2—-2hy 46302-22, 34362-301 
4e3.2-3ly 34362-33 


PRUGRAM MASK 343.2-31 

PROGRAM SEGMENT 34220-1 

PROGRAM STATUS wKORD {PSW) 3e3.0-1y 3e3e2—1, 3e3e02-2,4 Duo Bnd-2ls 30 362-22, 
Bede P2345 3436 2-3Oe Be Fe 2-Bhe Be 3n2-34y 3e3.2-36y 4eL04-1 THRU 401.4-3, 
Waleto de Gel Ste Seolel3-]ly Sele l3-3_ 402.0—-1) APPLA-5y APPLB~13 . 


Sw (StF PRKGGRAM STATUS WORD) 





ws 
E53 


6-1-68 27 - 
MSH REQUESI Be de2—3y BeFe2-30_ 36302—-3) 9 APPA 
PUNCH OPERAND OF CLOSIO COMMAND Bels2—1, APP.B-4 
PUNCH OPERAND OF OFFLINE COMMAND BeleLl-by BeloO-1e 3.1.21~-2, 3-Lebi~3, 


Ze1lell-& 344. 1-2, 3e4e2-8, §.3.0-1, 5-23.0-3, APP.B~-6 
PUT MACRO-INSTRUCTION 3e4-2122-1 
PUTX MACRO-INSTRUCTION Ze4ele2-1 


© (SEE QUIT REQUEST, QUERY CONSCLE FUNCTION) 
CUERY CONSOLE FUNCTION  4e1410~1Ly 6.0.0-le 401.0-1, 4elel0-25 APP.A 
CUIT REQUEST (EDIT ENVIR.)  34106-31, 30106-5, Beleb-8y 36401.2-10, APPLA 
CUIT REQUEST (SCRIPT EDIT ENVIR.) 301.1319, Bol-L3-3, 341413-7 

R  USEE RETYPC REQUEST, REPLACE REQUEST» RESET CCNSOLE FUNCTION) 

ohD (SEE READ CONTROL) 


ROGUE KACRO- ENSTRUCTION 3.4.1.2-7, Bah ele2-Be Bo4.1.2—1 FHRU BeGele2-4, 


30 40102-9 
REJFCH MACRO-INSTRUCTION 3.441.221 
READ CONTROL | 3.1613-40, 361613-7 


READ MACRO-LNSTRUCTIGN 3-4.1.2-1 


READ CRLY 2e1.0~-1,; 2e1.0-4y Zelel—-l, Zale3-2, 3el.7-1, 3.1.14-2, 3e4e)227-)1 

READ OPERAND OF OFFLINE COMMAND Belell-ly 362-0-1, 301611-2 THRU 3Belell~-4y 
3elell-6, Zeleli-T, 4Sele2~-1; 5.3.0-l, APP .LB-6 

READER GPERAND OF CLUSIO COMMAND Sele2—1ly APPB-4 


READY CONSOLE FUNCTICN 4.lelil-l, 202023, SeoleT—ly APP.A, Sale l}-3, 4&eleO-L, 


READY BESSAGE GLOSS, 2.2.2-3, 3.1.1-ly 30104~-2, Be le6-13, 
BeleG-14, 3.le7-Ly 3.1.10-5, Belwl2-2, 3.1.12-3, Zelwl5-2, 3.21.15~3, 
3. 1. 16-5, 30342-32, 343.2-33, Behe L.il-l, Bee 2-4 Be5e2-1L, 3.5.3-5, 


32 503-6 3e504-1y Be5eT1y MeOe0m1y GeleT—ly 4e200-1y 5eleO-], GLOSS-2 
REAL MACHINE 4ale2=Ly Gele6-ly 4eleB-ly Selell-1 
REAL TINE § GelelS~Ly Gel015-2 
RECEIVE INTERRUPT RPQ = 2.2e1-ly 20201-4 
RECORD = 2e2eO0-4) 3oLell~6y Balola-1y 3e1sl5-Ly Belel5-2¢ 301015-5y 301016-3 
Bele hT—2y 3.1. 134 3434227) 3641-3) 30401-7y Be4elel-4y Behcled—3, 


3e4e2~-2, 3e4e2-7 THRU 


JeX@ole2~4, Dedelet—~by, Jehule2—Tye Dedele2-10, 


ys 


LG 6-1-68 28 - 

a] sj 
Behe2—L1y 3e4e2-13y Be4ehel~Zy 3e503-hy 305e4—-2y 305.81) 305eL1-]y : 
APP. A-2 

RE-ENTRANCE = Behal~ly 3041-5) APPSB-15 


REGISTER (SEE ALSO FLOATING POINT REGISTER, GENERAL PURPCSE REGISTER) 

3302-25 Be3e2~lby Bere 2 lly 3e3e2~-21, 56 302-24, 343.2~33 THRY 

0302-36, Be4elel~L THRU 3442141-35 Sehole2-3y Be%ele 2-6 THRU 3s4ele2—-lly 

Behe le2—-1Lhy Ze4e1le2-1lit, bn4e1.2-15, Be%e1. 2-20, GLOSS-4, APP. A=], 

APP.B-3 
REGISTER 14 (SEE RETURN REGISTER) 
“RELOCATABLE GBJECT CODE 

Be2od-hy Ze2aT—ly 


3e220-), 3e1le16-2,% Be2e2—1y 322-3-1, Bete 3-2y 3e2e3-5y 
Be4el-l, 5a 3200-1 Sah e 0-2, GLOSS—4, APP. A-1 THRY APP.A~4 
RENT CPTICN 


Be4el—-1, APP.B-15 


REP = (SEE REPLACE CARD) 

REPEAT REQUEST — 34166-32, 36126-B8, 301-6-11y 301.6-28 

REPLACE CARD (REP) 5430-3 5430-59 Be2e3—by 3e2e3-2y 3a2e3—4y 3023-5, 
5e3.0-1, APP.B-15 

REPLACE REQUEST = 341413-20y 3ele13—21, Belel3—7y 2306-1, APPOA 

REPS FILETYPE = 34146-24 3.1.6~6 


REQUEST GLOSS, 243.0-1L THRU 2.3.0-3, 3.106-2 THRU 34166733, 3.2.13-2 THRU 
Be 1e13-139y 323021, 36302-4 THRU 32322-7, 36302-10 THRU 3e 322-19, 
3.1.0-1, 3.5.9~1, 36302-2)} THRU 3302-44, Gels O--2, GLOSS-3, APP.A-1, APP.B 

RESEND KEY 2.2.1-4 : 

RESET CONSOLE FUNCTION Gelel2-L,y 3eleLl-3,) 4elsO-Ly APPeA 

RESET LINE KEY (SEE ATTENTION KEY) 

RESIDUAL COUNT 303.2~11 

RESOURCES 1.0.0-1, 1.0.0-2 

RESPONSE (SEE ALSO TERMINAL CUTPUT) Be2al—2, 3.264-1, 365413~-2, Selel-ly 
Gelad-2s Selebm-ly GeleT—l, 4e1.10-1; 3-0.0-2, 3.1.19-1, 4.1.14-1, Gale l5-1 
GLOSS, GLOSS-4 

RESTART RCQUEST 3.1.13-5, 3.3.0-1y ZeBelmly 3.3.2-L, Ze3e2~3, 
Dodeteby Be3v2—-b3y 36342-27, 3e3e2-285 36302-3525 3a de 2-33, 3a3.3-1Ly 
36 3e4-3— APPA A 


RESTORE RCQUEST SeleS-ly 321.5-2 


RETURN KEY Za2edm dy 2a2el-3s 2e2ele4ae 2e2el~-by 2e2el-Ty Ze2e3-1k,y GLOSS~] 


RETURN MACRO-INSTRUCTICN Be4ehe2-h 





6-1) -08 LL 
ob 29 - 
RETURN REGISTER BeSale2—3y Be2e2—-33— Zohelel—le Bo4elel~Be Bahalel—4, 
RETURN REQUEST Bede2—Ly 3e302—-3B5 3030 2—-Se Be3d02-Te Be3e2-1Oy 3302-224 
3e5e2—le APP.A 
RETYPE REQUEST Bel e6~-33, 3ele6-39, 3126-8 s APPA 


REUSE COMHAND Be 2eC-ly 36 200-2, Be2el—Lby 3e202—-1 THRU 3e202-35 302.571 


Ze2eS-2y Ze2nb~-ly Be2eTt—lys Zalel~2y 523.0-1, §24e0-2y APPelhy APP.Am4, 
APP.B 

REWIND OPERANO OF TAPE COMMAND BelelS-Le BelelS5—2 THRU 341015-4, APP.B-7 
3.1.19-2 

REWIND REQUEST BeleS-Le 364%62-8, 344.2-9 

RIGHT ADJUSTMENT 303-22-34: 343.2~-38 

ROUTINE Be 24S by Ba2e Tr Ly 3030 2-334 Bede 2y ZBe4uLel—-le Bodelel—-3y Bo4elal~4, 
2e4ele2-1se Be4ele 2-2, Behe le 2m~Ay Bere lo2—Sy Be4eleae—Ts Be4elan2rDe 
BeGe lbs 2-10, Behele 2-19, Behvlo2-20e Be4e2—-22 Bateo2—-Jy Behtehmle 364e4s1-3y 
3eSell-lby 3459.13- 1, APP.B-16 

S$ (SEE SEEK REQUEST) 

S OPTICN Bede 2-1ly Bebe 2—-Ze APPWB-4 

SAMELAST OPERAND GF SEVOVER COMMAND — 3634471: 30 304-34 BoBn4m4ty Be Be4—by 
30 3e4-Te APP.B-6 ° 

SAVE MACRO-INSTRUCTICN Be4e).2-1 

SAVE REQUEST BeleO-3%y Belebrly BeleG-4 THRU 361-6-69 3olv6-8y Belab Boe 
3.1.6-36 . 

SCAN Be leb-20, 30401. 1-4 3e402-2y APPoA~by APPLAHT7 

SCRIPT COMMAND Belel3-l THRU 361.23-47y APP.Ay APPaAm4e APP.B 


SCRIPT EDIT ENVIRONMENT 20320-1 THRU 2.3.0-3¢ 341413-1 THRU 321.138, 


BeleL3-10_ Zalel3-Ll, 3el.13-13_ Be1.13-14, 3ele1L3-LBy BelL3-195 
3e1.13-23 

SCRIPT EDIT REQUESTS 3a2.13-2 THRU 361413-%2 APPsA-8s APP.Bs APP.B-12y 
3.1.13-6 

SCRIPT FILETYPE Belel3-1 THRU Beleb3-31 Bele l3-5y Bele b3-h5 

SCRIPT ENPUT ENVIR ONKFENT 2edeO-Ly 2e3e0-3y Belo 3-1 THRU 321.136, 321213-12 


THRU Bele l3-14y Bale) 3-20, 361413-21 


SCRIPT PRINT CONTRGL KORDS (SEE ALSO FORMAT CCNTRAL WORDS) 3.1213-8 THRU 
3.).13-43, APP eA, APP SEs APP.B-13, APP.8B-14 - 


SECCNDARY STICRAGE 1.0.0-1 


bi eo! 
; 6-1-68 sme 
SEEK REQUEST ZeleL3-22y 3SeLe13—-Ty APPA 
SEAIENTTAL FILE Bohe2-Byp Fe4e2—-De BeSe2-LE 
SER (SEE SERTAL REQUEST) 
SEREAL NUMBER Belel2-2 
SERTAL REQUEST BolaG-36y Bebo6-37p Bole6—-2, 3ele6—-5 THRU 36166-8, APPA 
SET CCNSOLE FUNCTION 4aleO-be, Sebo l4-2) 
SET LOCATION COUNTER (SLC} CARD Sade by $0300-2, 3220375) 
SET REQUEST| Be 3de2-3_y 30302-34 THRU 36302-3379 APPA 
SETERR* CURKAND BeBed—Le APPT, 3oF-O-Ly Beded—byp Be3al-3By Be 303-2, 30 303-3 
Be 304-3 3e5eG—by APPahy APPeA~be APPeA~3y APP.B 
SETOVER COMMAND 2n 304-1, APP.B-7_ 3.3-0-1, nae THRU 343¢1-39 346343-3, 
Be 304-2 THRU 3.364-7y 3e5e6—1n APPA, APPLA~Ly APP2A-3, APP.2By APP .B-1G 


SETUP PACRO-INSTRUCTION Bahele2—bp ZeGele2-) THRU 326.401 02-4) Zeta l.2-B 


SEVERTTY CODE BeSol-3y Be4el—-4_ Be4e2-24 32o40 2-4 
SINGLE SPACE CONTROL Beleh3-420 Bolel3-Ts Belel 3-44" Bele l 3-46 
SENV OPTION Ba2ed—hy 34203-2, APP.B-15 


SK. OPERANO OF TAPE COMMAND  362615-1, 3eh-15-2 THRU 3.2415-4) APP.B-7 

SLC (SEE SET LOCATION COUNTER CARD} . 

SLC 12000 OPTION  34263-1y APP.B-15 

SLC XXXXX OPTION  34263-1, APP.B-15 

SNOBCL COMMAND —324¢4-1 THRU 30426-4) APPeAy APPeAn4y APPoG, APPLB-T 

SNOBUL LANGUAGE — 3.4.4-1 THRU 30444-4s 344e4e1-1 THR 30404e1-4e APPeAW4 

SNOAOL USER'S MANUAL — 36404—-3y 3040-4 

SOURCE CODE 24 120-3y Be4e1-2y Bebe2—Ly 3a4a2-3e GeheO-Ly APPLB=15 

SOURCE LANGUAGE 3a Le 16-3) 364e2—Ly B04e2—-2e Bahehmly 3e4eh-3By 62000~1y 
640.0-3, 660.0-7 

SOURCE OPTION 304.21, 32462-2 THRU 3242-49 APP.B~15 


SOURCE PROGRAM (SEE SOURCE LANGUAGE) 


«SP (SEE SPACE CONTROL) 


SPACE CONTROL BeleL3-4l_ Bolbel3-7y 361.13-28, 3el.13-44 THRU 3.1.13-46 


% 


bf? - 6-1-68° bL3 


FEL 32 - 
6-1-68 =) . 
SVC INSTRUCTION (SEE ALSO CMS SVC, OS SVC) BaBdeOnmLy Be3e3-hy 326344-2, GLOSS-4 
SPIE MACRO-INSTRUCTICN Ze4ele2-l . Suc OLO PSti Be 3el~-3y 3323-1, 34304-2 
SPLI INTERPRETER LANGUAGE = 3404-1 THRU 3.4%04-4_ 3e4e4e1—-26 304e4ul—-3y APPLAK4 SUITCH PANEL = 2.2.1-7 é 
SPL/1LO A STRING PROCESSING LANGUAGE MARUAL 34a h~-4 SYMBOL NAME 363.2-12 THRU Bede 2—14, B2302—-1by 3e3e2-21¢ 34342-2853 3463-2-38 
SPL/1 CPYION Baheh— ly Behe 4? - SYMBCLIC ADORESS Beheol-ly 3e4.1-3—9 543.60-1, 3ete18-2 


SPLIT ConiAnD Belela~Ly APPsB—T— 30860-2, 3elel4-1 THRU 3.1614-3, APPoAy APP.B SYMBOLIC ARGUNINT C&EN) Be tefm dy Be 208-3, 3e5e3-L THRU 36563~35 620.0-1 


SPOOLING ARLA GLOSS) LeCoO-25 Bole lby Galeo2Q—le 4ele2—2_ SaleS-2s GeleB-1l, SYMBCLIC NAME Be4e le 2-18, 5e32.0-1¢ 543.0-2 
GLUSS— 3, APP LAWL 
SYNTAX ERROR 34422-2 
SREP BPTICN 3e2e3-1s 34263-45 APP.B-15 
SYSIN FILE Be4el-ly 324-1-7 


«SS (SEE SINGLE SPACE CONTROL) ; = 
SYSIN FILEVYPE — 34166-3)y Belell-49 3041-2, Beleb—ly 3ele6-29 Yeleb-7s 
ST (SEE STORE CONSGLE FUNCTION) - By leba15 
: i s 
STACKEC IKPUT 223.0-2 SYSLIB OPTION  30203-2¢ 302034 THRU 302.5—6) APP.B-15 
t 
START. COMMAND 342.0-Ly 3e2e6-Ly 20300-3_ 2ede2—by 2eBe2—2y 23.9 Le Be2eO--2y SYSULU MACLIG Be Le10-2) 3.1615-3) 36202-1 THRU 3e202-3y Be4el—3_ Behe be2-] | 
3.2.3-4, e2ebm2y 3e2e Bl, 3-2.8-3, 3Be3.2-Sy BaeSelal-ly APP.A, APP.B 524.0-1 . ; $ 

6.0.0-1 


SYSLIS6 TXILIB 3.22271 THRU Bele2—35 Be2e3-2y Be 2e3-by 50420-2 
START 1/0 INSTRUCTION 3ede2-10y 3.3.2-11h, 3.5.4-2 : ‘ 
SYSTEM ADMINESTRATOR 201-01 
STAT CCMNAND. 3.5.1l1l-l, 365011 -2, 3.5e-10-L; 6.0.0-1, APPohe APP.B 7 
SYSTEM DISK  -GLUSS) 2eleGely 241-0724 BeLeO-2y Bebel—Ly Bele3—-le BeleoB—2e 
STATE MACRO~INSTRUCTION = 344.142-5_y Be%ele2-i THRU 3e4ale2—4y Babel e2—by BebeB- Ly BelbsB-2_ Bole GL, AeleD-2y Belell—-ly Belell-2) Belell—4, 
3e4.1.2-f Bebol2—-ly Beledo-3_ Seated de Be2e2—-%y 3222 3-4y Be 2eH—- Ly 3030 2-26, 
BeBe T2y BahMolot—by Fe%eO-b, GLUSS~2, GLOSS—-4_ GLOSS~5 
STCP CPTIGN CF SCRIPT COFPAND Belel3-Ly 321413-2, 3012-13-37 : 
, . SYSTEM EFEICTENCY 1.6.0-1 
SYSTEM FILE GLOSS, 2e1leO-by 2abnO- 29 20160-49 Be2e2—]Ly Be l2a2—2y BoMehal—2y 2 
STCRE CONSOLE FUNCTICH 4ele1l3~-L, Z2edel~le 3Be3e2-1, 4eleO-ls 4e1613~2, 3.5e1l-2y. GLOSS-4 * 
4ulel3-3_ APPLA 
: SYSTEM FILE DIRECTORY Bate Ly Be2eB- ls 26 200-35 3.2684, 3650 l-bsy 3.501-2 
STCGRE REQUEST 3e3e2-32 36442-38 THRU 32.3.2-41, APPLA BeSelh--Ly 3e5e12-hy 365e12-2, GLOSS-2y APP.sA-1ly APPLA-4y 3400-1 


STRING — 3eleG-4y BeleG-14 THRU Bel.6-17%_ 30203-2) 3e206-Ly 362.81) 322082, SYSTEM LIBRARY (SEE ALSO SYSLIAB MACLIB, SYSLIB TXTLIA) 3a4el-31 604.0-2 
34 3.2-39; 3044-24 Za%t@e4ei-l THRU 3e46401-4y APP.LA—4, APPLCB-1, APP.B-9, : 
APPLB~ lly 3eleG-25, Belel3-9e Balel3—-10— Beiel3-i6, 3e1013-22 SYSTEM MASK 3.3.2-30 
STRING PRUCESSING LANGUAGE  34464~2 SYSTEM OPERAIGR  Belell-Gs 3eleLI—7y JebelS—4_ 3e4el—4y Babal—-7_ 3a5e4-1e ' 
deer ?y %.0.0-1, 4el.3-],y 4Gelet—ly 4oele9~ly GelLelO~-l, 4abl.l0~-2, 4e2e0-]y 
SUBROLTINE = 30200-1y 362.0-2) 34262-1 THRU 34202-35 30203-Ly 34203-2) 30203-4% , 4a2e0-2 ; 
THRU Be2e3-by Be2eb-Le Bebe 2-3_ Be4eG—2 THRU 32404-4, 304e4e1-1 THRU 
Behe hel 3, 564.0-2 SYSTEM RESET KCY  460.0-1p Gebal2—l, APPLA-11 
SUPERVISOR AND DATA MANAGEMENT MACRO-INSTRUCTIGNS KANUAL  324.1.2-1 SYSTEM TEXT LIBRARY = 30203-4 [6400-25 APP.B-3 F 
SUPERVISGR CALL (SEE SVC INSTRUCTION) : T (SEE TOP REGLEST) 


SUPERVISOR STATE 1.0.0-2, 3.3.2~1 


— ‘ 





66K 


6.1.68 33 - 


CPLRAND OF FORMAT COKMAND Babsdely APP.B-5 


TOPTICN  325ell—)y. 36 S.11-2 

TAK GETTING «20200 -3y 2e2e1-by Ze2el-Ty 2e2a3—ly Zedehr2e 2. Beb-2y 20307H1) 
Vobe 6-24 Bebe O-4 THRU Feleb—-Te BobeO-Lby Beleb-2%_ Beleb-27Ty 3eleb-3Us 
3.1.6-31 

Jeri (SEE TABDEF REGLEST) 

TALE REGUEST 30106*38, 3ale6-3y Seleb~B8y APPA 

TAN. (SEE FABSET RECLEST) 

TABSET RECUEST 30126-3959, 3. b26-405 Bele6-2¢ 341.678, APP.LA 

TAPE CCHHAND «= -3a2e15-by 26322-2¢ 3e1415-2 THRU 352015-5¢ APPoAy APP.B 

TAPE -MARK 3.201542 THRU 3elel5-S_ BolelB-Ly 301.19-2 

TAPE UNIT 120.0-25. 3.1.0-1 

TAPN CPLRANL 3.1. be-2 

PAS RET COMMAND 301. 1e=1, BalelB-2, BelelQ—Ly 3elel9—2_ APPLA—4, APP.B-7 


TEcePRENE LCOINE 202eG-ly 2e2e2-1 


wer wARY (USK GLOSS, 2.1.0-L_y 241.0-42 321.0-2, 3-1.1-1, Bele3-ls 30h 3-20 
Pe ae a Baba b~ 4s BebeoTnly 3.3.8-1, BeleB-2, ZeleI-le ZBeleli-l,s Belalin2, 
belebbeSy Lebel? dy Se2e2—Lby Fe 2a2—- 2p Be 2e3-4e Bele Bly Bede4n]y ee tet 
Veed be by Bee Lt 2, Gel eB-dy 5eleO-ly 564.0-Ly GLOSS~2, GLESS-4, GLOSS-5; 


AP Andy AMPLAnZ, APPL AW4 


TewPcr Ary FiLtc DERECTORY BeleT—ly Bele be 3e2e4—-hy 32208—-1y 34228-3) 34268-% 
4.U.0-1 j : 


TEWPCRARY wORK FILE 321.675 
L Dade O-1g LeCel—3, 200e0-1y 2eleO-}, 2eleO-4y 20200-2y 2e2el—ds 
THRU 2a2del-? 2e2e2-) THRU 2022-39 2e2e3-hy 203eO-1Ly. 203.0-24 
3.0c0-24 BebaO—by 3200-2) Bole2—Ly Belab—-2y 3eleb-3y 3o1le6-1bs 
p Beals l3B-3_ Belel3—4_ 3elel3-24y 32208-25 3020834 323.0-1e 
? 3.3.2-11, 3n342-15, Bede 2-1By 3.3.2-24) 32322-30, 3.342-31, 
, Bada 2-4ey a Pe aot EO) Betalo-he 3 4 1-2, Behal—by 3.4e1.2-15 
14 THRE 3e4eLe2—-b?_ 304e2-hy 204e2-Ahe Babe 2—Fe Beheheln—by 
2e 3.561 -2, 3.5.2~-15 3500 L's 365.3729 4.5213-]5 4.0.0-1+ 


TERMIN 


A 
2 
3 ’ 
3 1 
5) 0 
3 9 
3 
3 
4 


’ 4.1.9-1 GebwlO-2, 4022-07-15 be2e0-2s Fele O24 GLOSS-1 THRU 
s APP.LA-24 APPAW3, APP.B-3_ APPeB-15, 345.10-25 4elela-lt 


TERMINAL PODE SWITCH 2etel-be 2020173 


® 
i 


TERMINAL CUTPUT QaleO—4y 202.0-Le 2e2ul—-3y Se2el—by 2o203~ 1s 
FebaO 2, als God, Bele S THRU 261-6-By JeleG-TL THRU 361-26-15, JeleO-1 7 
THRU Selebow ty Se beé=25 THRU 3.1.6-27, 30166729 VHRU 3.1.G-34e Jede7 1) 
The Bele —$, Vole Br2_ 3ele9-b THRU 361.9-4, Bel-10-1Ly 3-1.10-3, 3el.ll-2 + 
TORU Boledde 2p Dele l@—b THRU Jobe b2—3_ Feleh3-2 THRE Jebel 3-5Se 31-13-85 


“JOP RECUEST (SCRIPT EDIT ENVIR.) 


bis 2 , | “ | bls 


A 6-21-68 ‘ee 


BebeL3-10, Felel3-2L3_ Bebel3-15 THRU 3.1023-25, 3e1613-27 THRU 3.1.13-31y 

FelelG-Ly Febel4-2_ Bobs bS-2 THRU BelabSn4_y JelehO~] THRU Jale 16-5) 
| Jelel7=3 THRU SelelI—5y Be2ol2y Je2ebe3y Fe2e2—-Be 30203525 32a amy 

Be 2e3-by Fe2ehm de Be20b— 2s Fe2a5— 24 Fe2eb—2y Be2e7T—1y Be2eB-2 THRU 

Bn 28-4, DeBdeln-le 3.3.1-3, 363,1-4, Sedet-2y 32-302-5 THRU Bede 2-Ty. 
Be2-LOy BeBe2-dly Bu Be2— 13s Bede2—V5y BoBe2—1 Ty BeBe 21s Jade 2-224 
Be 244 3030 2-265 Be3e2—-27: 36302-29 THRU 34302-33, 3e3e 2-35, 3030 2-374 
3.2- 39% sede they Bn de e-43y dede3d~2,y 343-373, ce a oat) THRU 3ede4~Te ; 
4ol-} THRU 3.4e1-3e Be4al-5 THRU Be%el~-7Ty Baholel-2y Bedale l~3y 
4o1l.2-3, Se4ole2-L4e Bedale 2-L5s 3e4e2-1 THRU Behva~4y 5e4a2—3y 
oft Behe 4 3y 3-541-2, 3e502-1y 3e5e03-2y 3n5e5-Ly Behe Te 3.5.8~1,5 
Sel2-l, 3. oe L3-Ly Bn 5eb3-2y 4eOeO~he Solel-ly 4ele2-24 Aala3d—hy Sele 3-2y 
Le4- Fy Aebodm-2y Nelo S~3p Gobo Ble 4oleDm ly GeolelO-by SelelO~2y 4Salel2~ly 
LeL3-2, 503, ots SeleO-b:y SeieO-2y GLOSS-3, APPsA-2¢ APP. A~3y APPaA—Sy 
0.0-1 THRU 640.0-8) APP.B=3¢ APP.B-5 


TERMINAL POWER SWITCH 2e2al35 2e202-3 


TERMINAL SESSION GLOSS, 20202—-be 20262-35 Dedel—le 3e30e2-17? 5 3e3s4~3, 3.5el-Ly. 
GLOSS--4_9- 3.5.9~), 3.5210-], 4eahelS-ls 6.0.0-) THRU 6.0.0-8 


TERMINAL TRANSMISSION  20340-2, 30522-1 
TERMINAL TYPEQUT (SEE TERMINAL OUTPUT) 


TEST 170 ENSTRUCTION 363.2-L1 


TEXT LIBRARY GLOSS, 3-1,0-1, 3.1-0-2, 3e1.216-L THRU 3.1.16-3, 30220-1, 3e2e27) 
THRU 36202-35 32203-4% THRU 36203-6) 5e4eO-1y 5e4e0-2, APPLA-2, APP .A~4 

T. | MACRO-INSTRUCTICN  3e4ebs2=1 | 

TIVE SFARING LeO.O-b, 3e%a2—-11_y GLOSS—2 


TIMER CONSDLE,FUNCTICN  4.1.0-Ly 4elelSmLy 4e1015-2 


«TM ©. (SEE TOP MARGIN CONTROL) 


¥CP MARGIN CONTROL Belbel3-43y Bobol3—-7e 301213744 


TOP REQUEST (EDIT ENVIR») Be beG-4hy Bebeb—4e Babeb-By Belab-10_ 36126714 
THRU 3-16-16, 3-16-20, 3Bele.6~-25, Buleb—-27,y Bale6-30, APP.LA 


Sele 13-23, 36 Lel3-3, 3elel3~7 
TRACE’ (SEE OVERRIDE) 


TRACE INFORMATION GLOSS, 963.0-1, 363-1-1 THRU 3.3.1-45 323-3~1 THRU 3.3-3-34 
30 304-3 THRU 36304-Ge 34566-1, GLOSS-3, APP.A-1_y APP.A-3_ APPLA~4 : 


TRANSLATE OPTICN OF SCRIPT COMMAND 3.1.13-1 


TRANSMIT INTERRUPT SPECIAL FEATURE 2e2el—-ly 262.1-4 

TRUNCATION 3.1.6-1: Bel 6-2, 3ele6~-7, 32126739; 3e1213-2, 3.1,413-10, 3eL-13-27 
Be bheL3-3Cy BeLeL 3-34, Be 30 2-3e 363 02-129 36302-34_ 343.2~38,y Be3e2-39, 
Be4elal-le 3e4ebe2-By 3e5e5-Ly APPLA-2 : 


6-1-68 


IXIL13 COMMAND 3.1-16-1 THRU 3e1.16-5, Bete2~2y 5 Ae 25 APP.LAsy APP.B 


TYPANATIC FEATURE 2.2.1-1 


TYPE MACRO-IRSTRUCTION 
3e4ele2-9 


Be%ele 2-14, Sede le2—-15, 344.1.2-1, Ze4Gelel—2s 


TYPE OPTION 362e3—1y 30203-29 30302-5¢ APPoD-15 


TYPEOUT (SEE TERMINAL OUTPUT) 


TYPEWRITER (SEE TERMINAL) 


TYPIN HACRO- INSTRUCTION Be4ele2—-lby 3e4ele2-17,¢ 3e4ele2~1,e 3e4e1.2~2 


TYPING ELEMENT  2e201-7y 3-1-6-3 


U CPTICN Bobet Ly 325e2-29 APP .B-4 


UFD GPERAND 3e5e9- le 365.9-2 


UNDEF INE COMMAND BeSeld2—Ly 2eBe2—2e BeSel—by 36501—2e 3e5e12—-2y APPLAs APP.B 


UNDEFINED LABEL Be4e2-2y 30422-4 


. 


UNDEFINED NAMES BeleSnm2y Be2eb— ly Ze2et—ly Be2elm2 


UNDEFINEO SYMBOLS 3+2.6~1y 342484 


UNIT CRKECK 3.5.4-2 


UNIT RECORD DEVICE GLOSS, Bele2—Le Ba4ele2—-ly 4e020-1, APP.A-1 


UNIT RECORO 1/0 1.0.0-2, Zele2—le 3¢1eli-l 


UNET STATUS 1<0.0-2 


UNRECOVERABLE ERROR Belly 332-1, Jade 2-2 303027331 Batel~3 


UP REQUEST (SEE ALSO BACKUP REQUEST} Bale6~425 3eleb-4, 3.1.6-8 


LPLATE COMMAND 3.2.O-1, JoLeLTH“L THRU Babel T—5_ APPLA, APPLA-Sy APP.DBe APP.B-8 


UPCATE FILE = 341.0-1 

USE COMMAND 3020-1 JZe2et—ls 3e2e0-2¢ Ze2el~le 34222-1 THRU Zu2e2—-se Be2e3-~by 
3.205-)5 3.20521 3.2e7-21 §23e0-1e §24.0-25 APPeAy APP.A~5S, APP.By 
APP.B-8 


USER-DEFINED COMMANDS BoSel-lLe BeSel-2e JeSelhbede 365.12-Le 325212-2) APP.A-4 


USER~CEFINED LIBRARY Be4el-3e 5040-2 


CSER FILE GLOSS, 2010-1, ZoleOm-2e 201.04 320201) 3ei1,i-l, ZelaT-2, 


3.1215-3, 3e5e4~-1, Ze4ele2—-2y Be4ele2—l3,e 3.5.8-l, 3.5.9-1, 3e 5210-1, 
524.0-Le GLOSS-4y APP.A-2 





LEE 


bb aw, 


6-1-68 Daye 


WSER FILE DIRECTORY (SEE ALSO PERMANENT FILE OIRECTORY, TEHPCRARY FILE 
DIRECTORY) 3u3e2-27, Zese2~32 Zelelt~4e BZeh&eolel-ly Be4ele2~5s 3258-1 
3.5.9-1, 3e5e1L0-Ly 345el0~2, 34529-2 : 

USERIC GLOSS, 2ele2-ls 2o2e22e 3e1e4-2, 3.1.11~-2 THRY 3Zelell—5S, 4ale2—le 

4e1.9-1Ly GLOSS-5_— G.0.60~2, APPLB-13 : 


VARTABLE LENGTH RECORD Zela3B-ly Zele3-2, Zele4-l, Bele l5—ly Ze4ele 2-6; 
2e4ele2—-Ty Zeh%ele2-lly Zelel9-2 


VER (SEE VERIFY RECUEST) 


VERIFY MODE Beleb-4y 36 le6-135 2eleb-10s 32146~-11, Ze-le6-1L5, 3.1-6-20, 
Be leG~2ly BeleO-234 Be leb~-25_ Beleb—-265 341.6-28) Bel e6~33— 341.6-43 


VERIFY REQUEST 3006-435 BeleG-13— 3¢166-8,. APPA 

VIRTUAL CGRE de3e2~-ly 32322-6, 323e2-13, 3322-15 THRU Zede2-lTe 32322-2115 
Fe Fe2— 226 Fe De 2-28 y 32636229 _ 303 02-38¢ 30 402-395 363502-42 

VIRTUAL INTERVAL TIMER 4e1.15-1, 4.1.15-2 

VIRTUAL MACHINE GLOSS: 1.0.0-1, 1.0.0-2, 1.0.0-3, Zelell-2, 36462~11; 
BeSell- 2s 4eOeO- Le Gebe3B-)e Geledmbs “4oleGm-ly GeleTrly SeleBrlhy Gelel2—ly 
4o2e0-1y Sel.O-2l, GLOSS-2, GLOSS-3, GLCSS-5 


VERTUAL MACHINE CONFIGURATION 1.0.0-2, 4Sala3~ly GeleT—le 4e2n0—-1y 4.2.0-2% 


WAIT MACRC-INSTRUCTION 2e4a1.2-1 


wAET RCUTENE Bode4-2 THRU 32364-4_ APPL B~16 


WATT STATE 3243-22-30 


WALTR MACRKO-INSTRUCTION Be 4ele 2-1 


WATTSAFME CPTIUN 30 304-29 Be 304-35 APP.B-16 


WAIT] CPTION 303-4-2, APP.B-16 


WAIT2 CPTION 3e3e4-2y Bedoh-4e 30304-6e APPLB~LE 


WORK FILE 321613-4, Be4e1-2 rT] Seleb—-Sy 3014675 : 
WRBUF MACRO-ENSTRUCTION Bohale2-10s BoGabe2—-Lls Be4ele2—bhe Butole2—2y 
3040142-4 ene 


WRETE MACRO-INSTRUCTION 3+4e1-2-1 
WRITEOF OPERANO OF TAPE COMMAND Bele lS—-ly 321e15-2 THRU 322-615~4, APP.B~T 
341419-2 


WRITAP COMMAND 3eLe16-1e BelslI-l, APP.A-S, APP .B-8, 3212192 


WIC MACRO-INSTRUCTION 3e4ehe2-t 


on 


WIOR MACRO-INSTRUCTION 
X OPTIGN - 
k REQUEST 
XCTL MACRO-INSTRUCTIGN 
XEQ OPTION 

XREF OPTICN 


1050 TERMINAL. 
1051 CONTROL UNIT 
1052 PRINTER KEYSOARE’ 
2741 TERMINAL 


$ COMMAND 


@ 
f 
iF 
v/s 


EN 


2.40. 2-1 
Zahele2-L?y BeSe2—ly 3eSe2—2y APPeB~4 


Zat%ele 2-1 
- be2e3d~2y Be2ut-4 THRU Be2e3n-by APP.B-15 


“Be4el-ly 364. 1~2>+ APP.8=15 


2e00O-Ly 26200-1y 20200-2, 
2.201~4 
REDS Lhe 2edeleT 
2s000-Ly 22200-by 2200-2, 


3e2.C“1y 3.2.8- 
6.0.0-1e APPA, APPLA-3) APP.A-Sy APP.B, APP.B-8 


(SEE CHARACTER-DELETE SYNBOL) 


(SEE LING-DELEVE SYMBOL) 

(SEE ASTERISK) a 

(SEE LOGICAL TAB CRARACTER, CGONTRCL SECTICN NAME) 
(SEE LOGICAL BACKSPACE CHARACTER) 


(SEE SYPBULIC ARGURENT) 


Bade 2-3y BeFe2-39p BeBe 2—4L THRU 36342~445 


Ze2el—A THRU 2eFZe1—-61 
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APPLA 


2e203-1 


Ze2ei-l THRU 2e2el-3, 2e2ad-h 


L EHRU 36 2e8—4_ BoleGe2e Bedel—-Zy Bahelel—-ly 3e4%02-13 


Previous Date 


7-19-68 
9-20-67 
9-21-67 
9-27-67 


9-27-67 


9-27-67 


4- 1-68 
7-31-67 
9-15-67 
4- 1-68 


9-18-67 
9-12-67 
7-19-68 
4- 1-68 
1-22-68 
7-19-68 
9-19-67 


8-16-67 
4- 1-68 
9-13-67 
9-18-67 
4- 1-68 
9-18-67 
9-18-67 
9-18-67 
9-21-67 
1-22-68 


: CP-67/CMS USIER'S GUIDE 


Update Temporary R2 


Section 


Table of Contents 
Terminal Usage 


Terminal Characteristics 


Logging Procedures 


Dialing a Multi-Access Syste 
General Typing Conventions 


Attention Interrupt 


Environment Conventions 


CMS Commands 
Alter | 

Closio 

Edit 


Listf 
Maclib 
Offline 
Script 


“Split 


Tape 

Txtlib 

State 

Tapeio 

Dumpf 

Dumpd 

Execution Control 
Genmod , 
Global 

Load 

Loadmod 

Reuse 

Start 

Use 

Assemble 

CMS Macros 

OS Macros — 
CMS Nucleus Routine 
Attn 

Cardph 

Cardrd 

Conwait 

Cpfunctn 

Desbuf 


y 
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i 
] 
-8t 
1 
} thru 4 
lthru2 
1 
lihru2, 
1 
} 
3 
& 


-Q- 
.O- 
wd 
.a- 
.3- 
14+ 
.5- 
0- 
»O-lthru2 
_l- 
.2- 
6+ 
t 


hru 45 


.9-lihrud 

.10-lthru 6 
.ll-Ithru7 
13-1 thru 69 


14-lthru3 


15-lthrué | 


16-lthrud 
20-1 


.21-lthru3 


22 
2.3 


‘ 0-1 thru z 
.1l-lthru2 
.2-)thru4 


3-lthru7 


-4-lthru3 


5-l thru 3 


.6-lthru2 


7-lthru3 
l-lthru9. 
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Pee ee 
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A thru 8B, 


.2-)thru2 
»3-l1thru2 
~4-lthru2 


5-1 - 69 


Page Numbers Action 
rd eee 


— 
> 


PrP POPP PADD ADAARD ADAP PrP PABA AADAD Wee Pru mr as 


bof 


New Date 


§- 1-69 
§- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
§~ 1-69 
h- 1-69 
5- 3-69 
5- J -69 
ll- )-66 
ll- 1-68 
5- 1-69 
5- 1-69 
5~ 1-69 
“B- 1-69 
l1l- 1-68 
§-°1-69 
10-23-68 
5- 1-69... 
§- 1-69 
Y}- 31-68 
1i- 1-68 .— 
_§- 1-69 o 
5- 1-69: 
5- 1-69 
§- 1-69 
5~ 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5~ 1-69 
§- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 
5- 1-69 


‘5- 1-69 | 


5-1-69 tt . " 


b 7d 5-1-69 Ly 
Frevious Date Section - Page Numbers Action New Date is 
Previous Date, ___ Section Page Numbers Action New Date 
ae -— 3.4.1.4.7-1 A 5- 1-69 ; 
Pinis — - 3.4.1,4,8-1 A 5- 1- ; 
Hndint / 2. 3,4.9,4.9-1thru2 A 5- 169 Seeupte: Jeetornat ae see) a ee a 
Hndsve - 3.4,.}.4,]0-)thru2A Be Labs 7-19-68 Tpl : 4.1. 7-) thrud R §- 1-69 
Logdsk ~ 3.4.1.4,11-1 A 5 269 9-17-67 Logout 4.1, 8-lthru2 R 5- 1-69 
Point - 3.4,1,4, 12-1 A 5B. 1-69 - 9-17-67 Msg °4.1.9-)thruz R 5-~ 1-69 
Printr ~ 3.4.3.4, 13-1 A Ge bah 4- 3-68 Query 4.1. 10-lthru3 R 5- 1-69 | 
Rabul F -~ 3.4,1.4,.14-1] AC 5B. 1-69 9-17-67 Ready 4,1. 11-1 R 5- 1-69 
State . --3.4.1,4.15-1 A 5. 1-69 4- 3-68 Set - 4.1. 14-lthru3 R 5- 1-69 
Tapeio - 3,4,.1,4. 16-lthru3 A Be 169 Xfer - 4.1.15-lthru3 D/A 5- 1-69 
Trap ce ee ee ee A 5- 1-69 Purge ~ 4.1, 16-1. A 5- 1-69 
Type - 3,4,1.4.18-1 A 5- 1-69 Sleep ~" 4,1, 17-1 o OA 5. 1-69 
Typlin - 3,4,1.4, 19-1 A ee Spool - 4,1.18- lthru3 A 5- 1-69 
Wait 2° 3.4.1.4, 20-1 A 5. 1-69 Disconn ~4,1.19 A 5- 1-69 
Waitrd "3.4.1.4, 21-Ithru2 A 5- 1-69 pean eee fs ee 
Wrbuf  « a Ae Oe ee A 5- 1-69 ‘7-19-68 Offline Procedures: Db: 2,0-1 R 5- 1-69, 
> 8 Fortran Programming ~"3,4,2,1-9thrull E 11- 1-68 Yape Procedures ~~ 5.5,0-1 A 5- 1-69 
6- 1-68° PLI “3,4, 3-)thruSd R 5- 1-69 CMS Batch Monitor — 7,0, 0-1 thru3 A l1- 1-68 
PL/I Programming “"3,4.3.1-lthrul2 A * 5. 1-69 // ¥ortran 7,2,1-2thru3 A 1}- 1-68 
Bruin - 3,4,5-lthru2 A 5. 1-69 // Assemble 7.:.2-l1 thru 3 A M1l- 1-68 
Luinend - 3.5, 1-)thru2d D/A 5- 1-69 // Text 7,2, 3-1 A 1l- 1-68 
7-19-68 Exec ~ 3.5. 3-Lthrull R ll- 1-68 // Dataset 7.2.4-1 A ll- 1-68 
1-22-68 Kx “3,5, 8-lthru2 R 5. 1-69 // Go 7.2. 5-lthru2 A ll- 1-68 
4- 1-68 Logout 77 3,5,10-lthru2 R 5- 1-69 // Punch 7.2. 6-1 A 11- 1-68 
Blip ac. eee D/A 5- 1-69 // Print 7.2,7-1 A 1l- 1-68 
Rt —- 3,5,15-1 A ll- 1-68 Running CMS Batch: 7.3, 0-lthru2 A L1- 1-68 
_Chardef - 3.5.16-lthru2 A 5- 1-69- Appendix A-14 E 11- 1-68 
Cpfunctn — 3.5,17-lthru2 A 5- 1-69 
Utilities - 3.6,0-1 A 5- 1-69 
CNVT26 ~3,6.1-1 A 5- 1-69 
Compare ~3,.6,2-1 A 5- 1-69 
CVTFV - 3.6,3-lthru2 A 5- 1-69 
Modinap ~3.6.4-1 A 5. 1-69 
Sort — - 3.6.5-l)thru3 A 5- 1-69 Hs 
Tpcopy - 3,6.6-)thru2 A £- 1-69 
Text Libraries ~3.7.0 A 1l- 1-68 
Syslib Txtlib 3.7. 1-) thru3 A Ll- 1-68 
Tapsct Routine -3.7.1.1-lthru3 A ll- 1-6 
Trap Routine -3.71.2 A l1- 1-68 
Blip Routine -3.7.1.3 A li- 1-68 : 
Logdsk Routine “3.7.1.4 A ll- 1-68 
Reread Routine -3.7.1.5 A 1l- 1-68 : 
° Define Routine ~3.7.1.6-lthru2 A ll- 1-68 
Dsdset Routine - 3.7.1,7-1 A ll- 1-68 . 
Getpar Routine ~3.71.8 —- A 11- 1-68 ‘ 
Cpnimon/Cpnmof Routines -3.7.1.9-lthru2 A 11- 1-68 
4- 3-68 Console Function Descriptions’ 4. 1. 0-] thru 2 R 5- 1-69 
7-19-68 Begin “4.1,1-) R 5- 1-69 
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IBM Cambridge Scientific Center 


CP-67/CMS Support Group 
545 Technology Square 


Cambridge, Massachusetts 02139 


May 26, 1969 


To: CP-67/CMS Installations 
| rae: 


Enclosed is one ‘copy of the rough drafts of updates to the CP-67/CMS 
User's Guide. _These updates reflect the contents of CMS Version I. 6 
and CP-67 Ve rsion 2.4, -These updates will be revised and corrected 
and sent out. formally to all holders of the User's Guide at a later date. 
Please note ‘that this is only a temporary update fox informing your 
users of the new contents of the system. 


Also enclosed is a write-up on the installation of the CMS Batch Monitor. 


The CP-67 Installation Guide does not explain how to define TTY 33 or 
35's in the REALIO deck. To define Teletype lines, use the type 
"ET357T" inthe DMXDV macro, For oom ? 


Ti yo24 DMXDV RDEVADD = 024, TYPE = TT35T, SAD = 2, x 
RDEVPNT = TT YO25 | fe 


_ The type TT35T defines a Teletype Model 33 or 35, wheteas the type 
2702T defines cither 1052 or 2741, The SAD address does not indicate 
the terminal type. — 


The following is 4 brief list of new changes and. additions to CP-67 and 
CMS: : 


CP-67 

1. | DIAL improvements, . 

2. | New user console functions - XFER, DIAL, PURGE, SLEEP, 
_SPOO!., DISCONN, LINK 

3. New operator console functions - DRAIN, START, SPACE, 

4. : Changes ta console functions = MSG, QUERY, EXTERNAL, 


~~ SET. 


CMS 


12, 


ce 
se ts 623 
New commands: 
CHARDEF TPCOPY 
LINEND MODMAP 
LINK STATE 
CPYFUNCTN TAPEIO 
SORT DUMPF 
CNVT26 DUMPD 
CVTFV BLIP 
COMPARE RT 


LISTF (EXEC) now creates the file CMS EXEC, not 
LISTF EXEC, 


When a command is typed in, the order of search is for 
an EXIC filetype and then a MODULE filetype. — 


Multiple commands 


can be stacked on one input line - 
See LINIEND, 


The line delete and character delete symbols, as well as 


‘the logical tab and backspace characters, can be 


redefined via. CHARDEF, 

The # is the default for the line- end character as well as 
the logical tab character, with the line- ‘end character 
taking precedence. 


Dynamic loader facilities. 


PL/I execution, 


- New SCRIPT PRINT options and control words. 


CP console functions can be issued from CP - bee CPFUNCTN. 


Mini-disks can be dynamically added to a user - see LINK 


Changes to the existing commands: 


LISTF MACLIB 

‘ OFFLINE TXTLIB 
TAPL GLOBAL 
START LOAD 
KX 


Good luck and ey Timesharing! 


Love Scawright 


G : : or 


vA uf : ; ee 
: 7s ~-2- : as 
CMS Batch Monitor Installation , 
Release I. 6 
Q: VERSION IDENTIFICATION: 
. oR: BATCH 1,6 (or any 15 bytes of prose) 

Using a copy of the NUCLEUS text deck of version I, 6, remove the 

DEBUG text deck - located about three /fourths into the deck and The nucleus will be written onto device CUU starting at cylinder N, 

preceeded by "OFFLINE READ DEBUG TEXT," Replace the Debug Then the message "READY" will be typed. 


deck with the following text decks: 
Before running any Batch job streams, IPL CUU. 
BATCH, BOMB, DECODECC, IPL, JCB, LIST, PRESTORE, od 
SYSCTL , 


‘These text decks may be obtained by assembling the respective source 
decks from the CMS SOURCE file. . 


Next, place the following REP cards into the NUCONTS deck - the first 
text deck after the loader deck: 


Cols: 1 2 7 14 50 
32-2-9 REP 000354 0010185, 0000, E3C1, D7F5 TAPS . 
12-2-9 REP 000360 0010186, 0000,F3Cl, D7F6 TAP6 
12-2-9 REP 000390 0010187, 0000,F£3C1,D7F7 TAP7 
And place the following REP into the BATCH text deck: 
12-2-9 REP 001034 001D046 ' IPL Rep 


On the BATCH virtual machine, IPL the nucleus card deck. The following 
questions will be asked: : ; 


Q: REWRITE NUCLEUS? 
R: YES. 
Prepare to write a core-image copy of the Batch Nucleus. 
Q: DEVICE ADDRESS? 
R: oCcUU . . ; 


Where CUU is the address of a disk area that will be used 
solely for the Batch nucleus - say, two cylinders on 
device 194, 


Q: STARTING CYLINDER? 

R: 00ON , 
Where N is at least "1" and not more than ''the number of 
cylinders minus one." Fora 2314, 2 cylinders is 


sufficient; 2311, 4 cylinders are needed. 





